.TH NWGRANT 8 5/19/2000 nwgrant nwgrant
.SH NAME
nwgrant \- Add Trustee Rights to a directory
.SH SYNOPSIS
\fBnwgrant\fP [ \fB-h\fP ] [ \fB-S\fP \fIserver\fP ] 
[ \fB-U\fP \fIuser name\fP ] [ \fB-P\fP \fIpassword\fP | \fB-n\fP ]
[ \fB-C\fP ] [ \fB-o\fP \fIobject name\fP | \fB-O\fP \fIobject id\fP ] 
[ \fB-t\fP \fItype\fP ] [ \fB-r\fP \fIrights\fP ] \fBfile/directory\fP

.SH DESCRIPTION
.B nwgrant
adds the specified bindery object with the corresponding trustee
rights to the directory.

\fBnwgrant\fP looks up the file \fI$HOME/.nwclient\fP
to find a file server, a user name and possibly a password. See
nwclient(5) for more information. Please note that the access
permissions of $HOME/.nwclient MUST be 600 for security reasons.

.SH OPTIONS

.B -h
.RS 3
.B -h
is used to print out 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
.RS 3
.B user
is the user name to use for login.
.RE

.B -P
.I password
.RS 3
.B password
is the password to use for login. If neither \fB-n\fP nor \fB-P\fP
are given, and the user has no open connection to the server, nwgrant
prompts for a password.
.RE

.B -n
.RS 3
.B -n
should be given if no password is required for the login.
.RE

.B -C
.RS 3
By default, passwords are converted to uppercase before they are sent
to the server, because most servers require this. You can turn off
this conversion by
.B -C.
.RE

.B -o
.I object name
.RS 3
The name of the object to be added as trustee.
.RE

.B -O
.I object id
.RS 3
The id of the object to be added as trustee.
.RE

.B -t
.I object type
.RS 3
The type of the object. \fIObject type\fP
must be specified as a decimal value. Common values are 1 for user
objects, 2 for group objects and 3 for print queues. Other values are
allowed, but are usually used for specialized applications. If you
do not specify \fIobject type\fP, \fIobject name\fP is taken as
NDS name.
.RE

.B -r
.I rights
.RS 3
You must tell \fBnwgrant\fP which rights it should grant to the bindery 
object.  The new rights for the object is specified by \fIrights\fP,
which can be either a hexadecimal number representing the sum of all
the individual rights to be granted or a string containing characters
representing each right.  Characters within the brackets may be in
any order and in either case.  Spaces are allowed between the 
brackets - in which case the entire string should be quoted.
Hexadecimal and character values for the rights are shown in this table:

    00 = no access
    01 = read access        = R
    02 = write access       = W
    08 = create access      = C
    10 = delete access      = E
    20 = ownership access   = A
    40 = search access      = F
    80 = modify access      = M
   100 = supervisory access = S

for a possible total of "1fb" or "[SRWCEMFA]" for all rights.
.RE

.B file/directory
.RS 3
You must specify the directory to which to add the object as
trustee. This has to be done in fully qualified NetWare notation.

Example:

nwgrant -S NWSERVER -o linus -t 1 -r fb 'data:home\\linus'

With this example, user linus is given all rights except supervisory
to his home directory on the data volume. This example assumes the 
existence of the file $HOME/.nwclient.

nwgrant -o linus -t 1 -r fb /home/linus/ncpfs/data/home/linus

With this example, user linus is given all rights except supervisory
to his home directory on the data volume. This example assumes that
NWSERVER is already mounted on /home/linus/ncpfs mountpoint.

.SH AUTHORS
nwgrant was written by Volker Lendecke with the corresponding NetWare
utility in mind. See the Changes file of ncpfs for other contributors.