.TH "XNSARCHIVE" 1 "3-MAR-87" "Xerox (WRC)"
.\" $Header: xnsarchive.n,v 1.1 87/04/01 13:56:18 ed Exp $
xnsarchive - Archive facility for XNS file servers
.B xnsarchive 
.B \-u
] [
.B \-v
] [
.B -l log-file
.B remote-file local-file
.I Xnsarchive
serializes the file named in \fIremote-file\fR into the file on the local
host named by \fIlocal-file\fR. The serialized format maintains both content
and attributes for the remote file and any descendant files if the file is
a directory. The resulting file can then be written to tape for archival
If \fIlocal-file\fR is \*(lq-\*(rq, then the output will be written to
\fIstdout\fR. This is useful for piping to other programs directly.
The arguments specified in \fIremote-file1\fR may be in one
of the following three forms, where host is a Clearinghouse name of the form 
\fIobject:domain:organization\fR (domain and organization are optional):
Credentials for accessing the remote service are determined either from the 
environment variables XNSNAME and XNSPASSWD or, if not defined, by prompting 
the user.
The possible options are:
.BI -l \ log-file
causes a summary of all files archived to be written to \fIlog-file\fR.
.B -u
causes the access list of the file named in \fIremote-file\fR to be propogated
to all descendants to eliminate potential access conflicts during 
.B -v
causes informational messages to be written to \fIstderr\fR along the way.
xnsrestore(1N), xnscreds(1N)
Filing Protocol, \s8XSIS\s0 108605 (May 1986)
Ed Flint