NetBSD Problem Report #45008

From neitzel@marshlabs.gaertner.de  Tue May 31 06:29:04 2011
Return-Path: <neitzel@marshlabs.gaertner.de>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by www.NetBSD.org (Postfix) with ESMTP id 66FFD63BA4F
	for <gnats-bugs@gnats.NetBSD.org>; Tue, 31 May 2011 06:29:04 +0000 (UTC)
Message-Id: <20110531062905.A670FB521@nguyen.marshlabs.gaertner.de>
Date: Tue, 31 May 2011 08:29:05 +0200 (CEST)
From: neitzel@marshlabs.gaertner.de
Reply-To: neitzel@marshlabs.gaertner.de
To: gnats-bugs@gnats.NetBSD.org
Subject: document all rcmd(1) options
X-Send-Pr-Version: 3.95

>Number:         45008
>Category:       bin
>Synopsis:       document all rcmd(1) options
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue May 31 06:30:00 +0000 2011
>Closed-Date:    Sat Jun 04 16:40:09 +0000 2011
>Last-Modified:  Sat Jun 04 16:40:09 +0000 2011
>Originator:     Martin Neitzel
>Release:        NetBSD 5.1_STABLE (2011-05-30)
>Organization:
	Gaertner Datensysteme, Marshlabs
>Environment:
System: NetBSD nguyen.marshlabs.gaertner.de 5.1_STABLE NetBSD 5.1_STABLE (NGUYEN) #0: Tue May 24 22:39:32 CEST 2011 neitzel@nguyen.marshlabs.gaertner.de:/u1/scratch/obj/sys/arch/i386/compile/NGUYEN i386
Architecture: any
Machine: any
>Description:
	Among other options,
	rcmd(1) has the -4/-6 options correctly working but not documented.

	rsh(1) has the -4/-6 options correctly documented but not working.

	Using rcmd -4/-6 instead is in fact a simple work-around until a fix
	for rsh(1) such as the one provided with PR lib/45007 is adopted;
	that fix depends on the yet undocumented rcmd(1) options.

	Both commands share the source and almost all options,
	set off by a mere -DIN_RCMD compile flag.

>How-To-Repeat:
	man 1 rcmd

>Fix:
	This patch documents the -4, -6 and -p port options, just as
	in rsh(1), mentions the possible "user@host" syntax, and elevates 
	the flags -d and -n into the SYNOSIS, too.

	There are no functional changes with the rcmd(1) program per se,
	so I didn't update the .Dd date.

	The diff is against netbsd-5 or -current (identical) as
	of today (2011-05-31).

Index: bin/rcmd/rcmd.1
===================================================================
RCS file: /cvsroot/src/bin/rcmd/rcmd.1,v
retrieving revision 1.19
diff -u -r1.19 rcmd.1
--- bin/rcmd/rcmd.1	30 May 2008 02:29:37 -0000	1.19
+++ bin/rcmd/rcmd.1	31 May 2011 06:05:16 -0000
@@ -63,6 +63,8 @@
 .Xr rcmd 3
 .Sh SYNOPSIS
 .Nm
+.Op Fl 46dn
+.Op Fl p Ar port
 .Op Fl l Ar username
 .Op Fl u Ar localusername
 .Ar host
@@ -84,6 +86,10 @@
 normally terminates when the remote command does.
 The options are as follows:
 .Bl -tag -width flag
+.It Fl 4
+Use IPv4 addresses only.
+.It Fl 6
+Use IPv6 addresses only.
 .It Fl d
 The
 .Fl d
@@ -97,6 +103,9 @@
 The
 .Fl l
 option allows the remote name to be specified.
+Another possible way to specify the remote username
+is the notation
+.Ar user@host .
 .It Fl u
 The
 .Fl u
@@ -110,6 +119,12 @@
 (see the
 .Sx BUGS
 section of this manual page).
+.It Fl p Ar port
+Uses the given
+.Pa port
+instead of the one assigned to the service
+.Dq shell .
+May be given either as symbolic name or as number.
 .El
 .Pp
 Shell metacharacters which are not quoted are interpreted on local machine,

>Release-Note:

>Audit-Trail:
From: "Christos Zoulas" <christos@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/45008 CVS commit: src/bin/rcmd
Date: Tue, 31 May 2011 06:24:44 -0400

 Module Name:	src
 Committed By:	christos
 Date:		Tue May 31 10:24:44 UTC 2011

 Modified Files:
 	src/bin/rcmd: rcmd.1

 Log Message:
 PR/45008: Martin Neitzel: document all rcmd(1) options. -46p were missing,
 and -d was not in the synopsis.


 To generate a diff of this commit:
 cvs rdiff -u -r1.19 -r1.20 src/bin/rcmd/rcmd.1

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: jruoho@NetBSD.org
State-Changed-When: Sat, 04 Jun 2011 16:40:09 +0000
State-Changed-Why:

This was fixed, thanks.



>Unformatted:

Home	PR Database Search