---
name: "nwgrant"
section: "8"
platform: "linux"
package: "ncpfs"
version: "2.2.6-9"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/nwgrant"
---

# nwgrant(8)

Add Trustee Rights to a directory

## NAME

nwgrant - Add Trustee Rights to a directory

## SYNOPSIS

**nwgrant** \[ **-h** \] \[ **-S** *server* \] \[ **-U** *user name* \] \[ **-P** *password* \| **-n** \] \[ **-C** \] \[ **-o** *object name* \] \[ **-t** *type* \] \[ **-r** *rights* \] **file/directory**

## DESCRIPTION

**nwgrant** adds the specified bindery object with the corresponding trustee rights to the directory.

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

## OPTIONS

- **-h**

  **-h** is used to print out a short help text.

- **-S** *server*

  **server** is the name of the server you want to use.

- **-U** *user*

  **user** is the user name to use for login.

- **-P** *password*

  **password** is the password to use for login. If neither **-n** nor **-P** are given, and the user has no open connection to the server, nwgrant prompts for a password.

- **-n**

  **-n** should be given if no password is required for the login.

- **-C**

  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 **-C.**

**-o** *object name*

The name of the object to be added as trustee.

**-t** *object type*

The type of the object. *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 *object type*, *object name* is taken as NDS name.

- **-r** *rights*

  You must tell **nwgrant** which rights it should grant to the bindery object. The new rights for the object is specified by *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.

**file/directory**

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.

## AUTHORS

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