65 lines
1.9 KiB
Groff
65 lines
1.9 KiB
Groff
.TH NWAUTH 1 10/27/1996 nwauth nwauth
|
|
.SH NAME
|
|
nwauth \- Verify username/password
|
|
.SH SYNOPSIS
|
|
.B nwauth
|
|
[ \fB-h\fP ] [ \fB-S\fP \fIserver\fP ] [ \fB-U\fP \fIuser name\fP ] [ \fB-P\fP \fIpassword\fP | \fB-n\fP ] [ \fB-D\fP ]
|
|
.SH DESCRIPTION
|
|
\fBnwauth\fP
|
|
does nothing but logging into a NetWare server. If the login was
|
|
successful, an error code of 0 is returned. If the login was not
|
|
successful, an error code of 1 is returned. It was designed for
|
|
use by other programs who want authenticate users via a NetWare
|
|
server.
|
|
|
|
If there is no \fB-P\fP or \fB-n\fP option specified on command line,
|
|
nwauth \fBalways\fP expects a password on stdin. If the stdin is a tty,
|
|
then the user is prompted for a password. Otherwise nwauth simply reads
|
|
stdin for a password.
|
|
|
|
.B nwauth
|
|
looks up the file \fI$HOME/.nwclient\fP to find a file server and
|
|
a user name if they are not specified on command line. See nwclient(5)
|
|
for more information. Please note that the access permissions of \fI.nwclient\fP
|
|
MUST be 600, for security reasons.
|
|
|
|
.SH OPTIONS
|
|
|
|
.B -h
|
|
.RS 3
|
|
.B -h
|
|
is used to print a short help text.
|
|
.RE
|
|
|
|
.B -S
|
|
.I server
|
|
.RS 3
|
|
.B server
|
|
is the name of the server you want to use.
|
|
.RE
|
|
|
|
.B -U
|
|
.I user name
|
|
.RS 3
|
|
If the user name your NetWare administrator gave to you differs
|
|
from your unix user-id, you should use
|
|
.B -U
|
|
to tell the server about your NetWare user name.
|
|
.RE
|
|
|
|
.B -D
|
|
.RS 3
|
|
\fBnwauth\fP says that your password is correct if you have existing
|
|
connection to \fIserver\fP with name \fIuser name\fP. This is handy
|
|
for some shell scripts, but it is unacceptable for authorization
|
|
modules, such as PAM, PHP or Apache. It was pointed to me that
|
|
this behavior was not well known, and there exist at least one PAM
|
|
module which does not know that (this module is not part of ncpfs; you
|
|
should use PAM module which comes with ncpfs instead anyway).
|
|
.RE
|
|
.SH SEE ALSO
|
|
.B nwclient(5)
|
|
|
|
.SH CREDITS
|
|
nwauth was written by Volker Lendecke (lendecke@math.uni-goettingen.de)
|