NAME

niutil − NetInfo utility

SYNOPSIS

niutil [ -t ] [ -p ] -createprop domain path propkey [ propval ... ]

niutil [ -t ] [ -p ] -destroyprop domain path propkey

niutil [ -t ] [ -p ] -read domain path

niutil [ -t ] [ -p ] -list domain path

niutil [ -t ] [ -p ] -create domain path

niutil [ -t ] [ -p ] -destroy domain path

DESCRIPTION

niutil lets you to do arbitrary reads and writes on the given NetInfo domain.  In order to perform writes, niutil must be run as root on the NetInfo master for the database, unless the −p option is given.  The directory specified by path is separated by "/"s, similar to UNIX.  The property names may be given in the path using a "=", but will default to the property name "name".  For example, the following refers to a user with the user ID 3. 

"/name=users/uid=3"

The following shorter form would also be sufficient:

"/users/uid=3"

You may specify a numeric ID for the directory instead of the string path. 

OPTIONS

-t Interpret the domain as a tagged domain.  For example, "parrish/network" refers to the database tagged "network" on the machine "parrish".  You may supply an IP address instead of a machine name. 

-p Prompt for the root password of the given domain so that one can run from other locations in the network besides the master. 

-createprop domain path propkey [ propval ... ]
Create a new property in the directory path.  propkey refers to the name of the property; 0 or more property values may be specified.  If the named property already exists, it’s overwritten. 

-destroyprop domain path propkey
Destroy the property with name propkey in the given path. 

-list domain path
List the directories in the given domain/path.  The directory ID’s are listed along with any names they may have.

-read domain path
Read the properties associated with the directory specified in the given path.

-create domain path
Create a new directory with the given path.

-destroy domain path
Destroy the directory with the given path.

EXAMPLE

"niutil -list . /" list the directories at the top level in the local NetInfo database. 

SEE ALSO

niload(8), nidump(8), netinfo(5)

NeXT Computer, Inc.  —  June 20 1989