opendarwin man page for niload

NILOAD(8)						      System Manager's Manual							 NILOAD(8)

NAME
       niload - load text or flat-file-format data into NetInfo

SYNOPSIS
       niload [ -v ] [ -d ] [ -m ] [ -p ] [ -t ] { -r directory | format } domain

DESCRIPTION
       niload  loads information from standard input into the given NetInfo domain.  If format is specified, the input is interpreted according to
       the flat-file file format of the same name.  The allowed values for format are aliases, bootparams, bootptab, exports, fstab, group, hosts,
       networks, passwd, printcap, protocols, rpc, and services.

       If -r directory is specified instead of a flat-file file format, the input is interpreted as "raw" NetInfo data, as generated by nidump -r,
       and loaded into directory.  Note that this operation will delete and replace the entire NetInfo subtree at the  specified  directory.   Any
       existing records in this subtree will be lost.

       niload  overwrites  entries  in	the existing directory with those given in the input.  Entries that are in the directory aren't deleted if
       they don't exist in the input, unless the -d option is specified.  niload must be run as superuser on the master  NetInfo  server  for  the
       given domain, unless one specifies the -p option, which allows one to run from anywhere in the network.

OPTIONS
       -v     Verbose.	Prints details of records as they are updated (flat-file formats only).

       -d     Delete entries which are in the directory, but not in the input.

       -m     Merge properties and values.  Existing properties will be preserved in the database if they are not present in the input.  For exam-
	      ple, if a user record has a "picture" property, loading a passwd-format record for this user will preserve the  property.   Property
	      values are also merged.

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

       -t     Interpret  the  domain  as  a  tagged domain.  For example, "trotter/network" refers to the database tagged "network" on the machine
	      "trotter".  The machine name can be an actual name or an IP address.

       -r     Load entries in "raw" format, as generated by nidump -r.	The first argument should be the path of a NetInfo  directory  into  which
	      the  information	is  loaded.  Since the input often specifies properties (including "name") at its topmost level, the directory you
	      specify may be renamed as a result of this operation.  If the directory you specify does not exist, it will be created.

EXAMPLES
       "niload passwd . < /etc/passwd" loads the local /etc/passwd file into the local NetInfo database.

       "niload -d -r /locations ."  replaces the contents of /locations in the local domain with input given in nidump "raw" format.

SEE ALSO
       nidump(8), niutil(8), netinfo(5), aliases(5), bootparams(5), bootptab(5), exports(5), fstab(5), group(5), hosts(5), networks(5), passwd(5),
       printcap(5), protocols(5), rpc(5), services(5)

Apple Computer, Inc.						 December 22, 1992							 NILOAD(8)