Debian Bug report logs - #352136
passwd: arguments in the passwd.1 synopsis should match the ones used in the OPTIONS section

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Dan Jacobson <jidanni@jidanni.org>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: passwd: UNIX or Linux?

Date: Fri, 10 Feb 2006 00:37:23 +0800

Package: passwd
Version: 1:4.0.13-7
Severity: wishlist

# COLUMNS=7777 man passwd|spell
TheUNIX
# passwd
Enter new UNIX password:
Retype new UNIX password:

Looks like I'm connected to an AT&T UNIX machine. Better to say Linux
or better yet the hostname itself, in case one is ssl'ed several
layers thick and must be sure about what machine one is changing the
passwd of.

Also on the man page the long --options are not in the SYNOPSIS,
and these
     passwd [-x max] [-n min] [-w warn] [-i inact] login
should probably be
     passwd [-x MAX_DAYS] [-n MIN_DAYS] [-w WARN_DAYS] [-i INACTIVE_DAYS] login
to match the below part of the man page, or at least say
     passwd [-x days] [-n days] [-w days] [-i days] login
and INACTIVE should be INACTIVE_DAYS to match the others...

Also
$ passwd
Changing password for jidanni
(current) UNIX password:
Enter new UNIX password:
Retype new UNIX password:
Bad: new password is too short

  Only now you tell me, after having typed it twice.

Enter new UNIX password:
Retype new UNIX password:

 User cannot ^C out of it. User thinks oh no, my password will now be
 some control chars I hit trying to escape.

Sorry, passwords do not match
passwd: Authentication information cannot be recovered

 Better to say "password unchanged". "Authentication information
 cannot be recovered" sounds like he just deleted his account.

Message #10 received at 352117@bugs.debian.org (full text, mbox, reply):

From: Nicolas François <nicolas.francois@centraliens.net>

To: Dan Jacobson <jidanni@jidanni.org>, 352117@bugs.debian.org

Subject: Re: Bug#352117: passwd: UNIX or Linux?

Date: Thu, 9 Feb 2006 23:33:51 +0100

tags 352117 upstream
clone 352117 -1 -2 -3
retitle  -1 passwd: typo in the passwd manpage "TheUNIX"
severity -1 minor

retitle  -2 passwd: arguments in the passwd.1 synopsis should match the ones used in the OPTIONS section
severity -2 wishlist

retitle  -3 passwd: when interrupted, passwd should indicate that the password was not changed
severity -3 wishlist
thanks

On Fri, Feb 10, 2006 at 12:37:23AM +0800, jidanni@jidanni.org wrote:
> Package: passwd
> Version: 1:4.0.13-7
> Severity: wishlist

Thanks for the report. I've cloned you patch to separate the different
issues.

> # COLUMNS=7777 man passwd|spell
> TheUNIX

[BUG -1]
I will commit a patch tonight.

> # passwd
> Enter new UNIX password:
> Retype new UNIX password:
> 
> Looks like I'm connected to an AT&T UNIX machine. Better to say Linux
> or better yet the hostname itself, in case one is ssl'ed several
> layers thick and must be sure about what machine one is changing the
> passwd of.

[BUG 352117]
I think we can drop "UNIX". IMHO, this "UNIX" indicates it is dealing with
the /etc/passwd password. This is no more the case with a PAMified passwd.
I will check this with upstream.

> Also on the man page the long --options are not in the SYNOPSIS,
> and these
>      passwd [-x max] [-n min] [-w warn] [-i inact] login
> should probably be
>      passwd [-x MAX_DAYS] [-n MIN_DAYS] [-w WARN_DAYS] [-i INACTIVE_DAYS] login
> to match the below part of the man page, or at least say
>      passwd [-x days] [-n days] [-w days] [-i days] login
> and INACTIVE should be INACTIVE_DAYS to match the others...

[BUG -2]
In the other shadow utilities' man pages, the synopsis is minimally set to:
<tool> [options] <args>

So this synopsis will probably switch to a similar form.
Otherwise, I agree there's an inconsistency, and the long options could be
indicated.

> Also
> $ passwd
> Changing password for jidanni
> (current) UNIX password:
> Enter new UNIX password:
> Retype new UNIX password:
> Bad: new password is too short
> 
>   Only now you tell me, after having typed it twice.
> 
> Enter new UNIX password:
> Retype new UNIX password:
> 
>  User cannot ^C out of it. User thinks oh no, my password will now be
>  some control chars I hit trying to escape.
> 
> Sorry, passwords do not match
> passwd: Authentication information cannot be recovered
> 
>  Better to say "password unchanged". "Authentication information
>  cannot be recovered" sounds like he just deleted his account.

[BUG -3]
A lot is done by PAM in passwd, I will check if we can detect this case
and inform the user that the password was not changed.

Kind Regards,
-- 
Nekral

Message #23 received at 352136@bugs.debian.org (full text, mbox, reply):

From: Christian Perrier <bubulle@debian.org>

To: 352136@bugs.debian.org

Subject: Re: [Pkg-shadow-devel] Processed: Re: Bug#352117: passwd: UNIX or Linux?

Date: Fri, 10 Feb 2006 06:58:38 +0100

> > retitle  -2 passwd: arguments in the passwd.1 synopsis should match the ones used in the OPTIONS section
> Bug#352136: passwd: UNIX or Linux?
> Changed Bug title.
> 
> > severity -2 wishlist
> Bug#352136: passwd: arguments in the passwd.1 synopsis should match the ones used in the OPTIONS section
> Severity set to `wishlist'.

Here's Solaris behaviour:

cpeperrier@samba:~> passwd
passwd:  Changing password for cperrier
Enter login password:
New password:


> 

Message #28 received at 352136-forwarded@bugs.debian.org (full text, mbox, reply):

From: Christian Perrier <bubulle@debian.org>

To: Tomasz Kłoczko <kloczek@zie.pg.gda.pl>

Cc: 352136-forwarded@bugs.debian.org

Subject: Proposed patch for passwd.1 synopsis consistency

Date: Tue, 28 Feb 2006 18:48:34 +0100

tags 352136 patch
thanks

The attached patch makes the command synopsis in passwd.1 consistent
with the policyt of other shadow man pages, in answer to Debian bug
#352136 and after considering Nicolas comments in the bug log.

Tomasz, would you consider applying it?


-- 

Message #33 received at 352136@bugs.debian.org (full text, mbox, reply):

From: Christian Perrier <bubulle@debian.org>

To: 352136@bugs.debian.org

Subject: Patch, really

Date: Tue, 28 Feb 2006 19:43:24 +0100

[Message part 1 (text/plain, inline)]

-- 

[402_passwd.1-synopsis (text/plain, attachment)]

Message #44 received at 352136-done@bugs.debian.org (full text, mbox, reply):

From: Christian Perrier <bubulle@debian.org>

To: 352136-done@bugs.debian.org

Subject: Bug closed

Date: Fri, 24 Mar 2006 18:35:33 +0100

[Message part 1 (text/plain, inline)]

Version: 4.0.15-1

This bug was closed by the upload in experimental and the fix is now
also in unstable.


-- 

[signature.asc (application/pgp-signature, inline)]

Send a report that this bug log contains spam.