.\" @(#)niload.8 92/05/07 JJ .TH NILOAD 8 "December 22, 1992" "Apple Computer, Inc." .SH NAME niload \- load text or flat-file-format data into NetInfo .SH SYNOPSIS .B niload [\ \fB\-v\fR\ ] [\ \fB\-d\fR\ ] [\ \fB\-m\fR\ ] [\ \fB\-p\fR\ ] [\ \fB\-t\fR\ ] {\ \fB\-r\fR\ \fIdirectory\fR\ |\ \|\fIformat\fR\ } \fIdomain\fR .SH DESCRIPTION .I niload loads information from standard input into the given NetInfo .IR domain . If .I format is specified, the input is interpreted according to the flat-file file format of the same name. The allowed values for \fIformat\fR are .BR aliases , .BR bootparams , .BR bootptab , .BR fstab , .BR group , .BR hosts , .BR networks , .BR passwd , .BR printcap , .BR protocols , .BR rpc , and .BR services . .PP If \fB\-r\fR\ \fIdirectory\fR is specified instead of a flat-file file format, the input is interpreted as \*(lqraw\*(rq NetInfo data, as generated by \fBnidump\ \-r\fR, and loaded into \fIdirectory\fR. 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. .PP .I 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 \fB\-d\fR option is specified. .I niload must be run as superuser on the master NetInfo server for the given domain, unless one specifies the .B \-p option, which allows one to run from anywhere in the network. .SH OPTIONS .TP .B \-v Verbose. Prints details of records as they are updated (flat-file formats only). .TP .B \-d Delete entries which are in the directory, but not in the input. .TP .B \-m Merge properties and values. Existing properties will be preserved in the database if they are not present in the input. For example, if a user record has a \*(lqpicture\*(rq property, loading a passwd-format record for this user will preserve the property. Property values are also merged. .TP .B \-p Prompt for the root password of the given domain so that one can run from other locations in the network besides the master. .TP .B \-t Interpret the domain as a tagged domain. For example, \*(lqtrotter/network\*(rq refers to the database tagged \*(lqnetwork\*(rq on the machine \*(lqtrotter\*(rq. The machine name can be an actual name or an IP address. .TP .B \-r Load entries in \*(lqraw\*(rq format, as generated by \fBnidump \-r\fR. The first argument should be the path of a NetInfo directory into which the information is loaded. Since the input often specifies properties (including \*(lqname\*(rq) 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. .SH SYSTEM USAGE Most processes on Mac OS X access the information from the files in /etc and from NetInfo indirectly through the system library and the \fBlookupd\fR daemon. In some cases the files in /etc are consulted before NetInfo, making it unnecessary to copy information from these files into NetInfo. The files /etc/hosts, /etc/networks, /etc/services, /etc/protocols, and /etc/rpcs are consulted before NetInfo. .PP Additionally, the /etc/exports file is the primary source for NFS file share configuration. .I niload no longer supports loading NFS file share information into NetInfo. .PP See lookupd(8) for more information. .SH EXAMPLES \*(lqniload passwd . < /etc/passwd\*(rq loads the local /etc/passwd file into the local NetInfo database. .PP \*(lqniload \-d \-r /locations .\*(rq replaces the contents of /locations in the local domain with input given in \fInidump\fR \*(lqraw\*(rq format. .SH "SEE ALSO" lookupd(8), nidump(8), niutil(8), netinfo(5), aliases(5), bootparams(5), bootptab(5), fstab(5), group(5), hosts(5), networks(5), passwd(5), printcap(5), protocols(5), rpc(5), services(5)