164 lines
3.5 KiB
Groff
164 lines
3.5 KiB
Groff
.TH NWGRANT 8 5/19/2000 nwgrant nwgrant
|
|
.SH NAME
|
|
nwgrant \- Add Trustee Rights to a directory
|
|
.SH SYNOPSIS
|
|
.B nwgrant
|
|
[
|
|
.B -h
|
|
] [
|
|
.B -S
|
|
.I server
|
|
] [
|
|
.B -U
|
|
.I user name
|
|
] [
|
|
.B -P
|
|
.I password
|
|
|
|
|
.B -n
|
|
] [
|
|
.B -C
|
|
] [
|
|
.B -o
|
|
.I object name
|
|
] [
|
|
.B -t
|
|
.I type
|
|
] [
|
|
.B -r
|
|
.I rights
|
|
]
|
|
.B file/directory
|
|
|
|
.SH DESCRIPTION
|
|
.B nwgrant
|
|
adds the specified bindery object with the corresponding trustee
|
|
rights to the directory.
|
|
|
|
.B nwgrant
|
|
looks up the file
|
|
.I $HOME/.nwclient
|
|
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
|
|
.B -n
|
|
nor
|
|
.B -P
|
|
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 -t
|
|
.I object type
|
|
.RS 3
|
|
The type of the object.
|
|
.I Object type
|
|
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
|
|
.B nwgrant
|
|
which rights it should grant to the bindery object.
|
|
The new rights for the object is specified by
|
|
.I rights,
|
|
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. If rights are represented in string format
|
|
then the string must be bounded with square brackets. 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.
|
|
|