.\" @(#)nidump.8 92/04/28 JJ
.TH NIDUMP 8 "December 22, 1992" "Apple Computer, Inc."
.SH NAME
nidump \- extract text or flat-file-format data from NetInfo
.SH SYNOPSIS
.B nidump
[\ \fB\-t\fR\ ]
{\ \fB\-r\fR\ \fIdirectory\fR\ |\ \|\fIformat\fR\ }
\fIdomain\fR
.SH DESCRIPTION
.I nidump
reads the specified NetInfo
.I domain
and dumps a portion of its contents to standard output.
When a flat-file administration file
.I format
is specified,
.I nidump
provides output using the syntax
of the corresponding flat file.
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 the
.B \-r
option is used, the first argument is interpreted
as a NetInfo directory path,
and its contents are dumped
in a generic NetInfo format.
.SH OPTIONS
.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"
Dump the specified directory in \*(lqraw\*(rq format. Directories are delimited by curly braces, and properties within a directory are listed in the form \*(lqproperty = value;\*(rq. Parentheses introduce a comma-separated list of items. The special property name CHILDREN is used to hold a directory's children, if any are present. Spacing and line breaks are significant only within double quotes, which may be used to protect any names that might contain metacharacters.
.SH "EXAMPLES"
.PP
\*(lqnidump hosts .\*(rq dumps a hosts file
from the local NetInfo domain.
.PP
\*(lqnidump \-r /locations /\*(rq dumps
the /locations directory of the root domain.
.PP
\*(lqnidump \-t \-r /name=users/uid=530 trotter/network\*(rq dumps the directory for the user whose UID is 530.
.SH "SEE ALSO"
niload(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)
.\" bootptab(5) -- no manual entry; see Lennart Lovstrand