10564b1175
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
45 lines
1.2 KiB
Groff
45 lines
1.2 KiB
Groff
.TH PASSWD 1
|
|
.SH NAME
|
|
passwd, netkey \- change user password
|
|
.SH SYNOPSIS
|
|
.B passwd
|
|
[
|
|
.I username\fR[@\fPdomain\fR]\fP
|
|
]
|
|
.PP
|
|
.B netkey
|
|
.SH DESCRIPTION
|
|
.I Passwd
|
|
changes the invoker's Plan 9 password and/or APOP secret.
|
|
The Plan 9 password is used to login to a terminal while
|
|
the APOP secret is used for a number of external services:
|
|
POP3, IMAP, and VPN access. The optional argument specifies
|
|
the user name and authentication domain to use if different
|
|
than the one associated with the machine
|
|
.I passwd
|
|
is run on.
|
|
.PP
|
|
The program first prompts for the old Plan 9 password in the specified
|
|
domain to establish
|
|
identity.
|
|
It then prompts for changes to the password and the
|
|
secret.
|
|
New passwords and secrets must be typed twice, to forestall mistakes.
|
|
New passwords must be sufficiently hard to guess.
|
|
They may be of any length greater than seven characters.
|
|
.PP
|
|
.I Netkey
|
|
prompts for a password to encrypt network challenges.
|
|
It is a substitute for a SecureNet box.
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/netkey.c
|
|
.br
|
|
.B \*9/src/cmd/auth/passwd.c
|
|
.SH "SEE ALSO"
|
|
.MR encrypt 3
|
|
.PP
|
|
Robert Morris and Ken Thompson,
|
|
``UNIX Password Security,''
|
|
.I AT&T Bell Laboratories Technical Journal
|
|
Vol 63 (1984), pp. 1649-1672
|