4.4BSD/usr/src/contrib/xns/man/xnsarchive.n

.TH "XNSARCHIVE" 1 "3-MAR-87" "Xerox (WRC)"
.\" $Header: xnsarchive.n,v 1.1 87/04/01 13:56:18 ed Exp $
.SH NAME
xnsarchive - Archive facility for XNS file servers
.SH SYNOPSIS
.B xnsarchive 
[
.B \-u
] [
.B \-v
] [
.B -l log-file
]
.B remote-file local-file
.SH DESCRIPTION
.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
purposes.
.PP
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.
.PP
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):
.nf
	[host]filename
	(host)filename
	host:filename
.fi
.PP
Credentials for accessing the remote service are determined either from the 
environment variables XNSNAME and XNSPASSWD or, if not defined, by prompting 
the user.
.PP
The possible options are:
.TP
.BI -l \ log-file
causes a summary of all files archived to be written to \fIlog-file\fR.
.TP
.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 
serialization.
.TP
.B -v
causes informational messages to be written to \fIstderr\fR along the way.
.SH "SEE ALSO"
xnsrestore(1N), xnscreds(1N)
.br
Filing Protocol, \s8XSIS\s0 108605 (May 1986)
.SH AUTHORS
Ed Flint