.\" @(#)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\-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 exports ,
.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.
.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.
Print a \*(lq+\*(rq for each entry loaded,
a \*(lq\-\*(rq for each entry deleted (flat-file formats only).
.TP
.B \-d
Delete entries which are in the directory,
but not in the input.
.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 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"
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)