adv(8) CLIX adv(8)
NAME
adv - Advertises a directory for remote access
SYNOPSIS
adv [-r] [-d description] resource pathname [clients ... ]
adv -m resource -d description [clients ... ]
adv -m resource [-d description] clients ...
adv
DESCRIPTION
The adv command is the Remote File Sharing command used to make a resource
from one computer available for use on other computers. The machine that
advertises the resource is called the server, while computers that mount
and use the resource are clients. (See mount). (A resource represents a
directory, which could contain files, subdirectories, named pipes and
devices.)
There are three ways adv is used:
1. pathname under the name resource so it is available to Remote File
Sharing clients;
2. description fields for currently advertised resources; or
3. display a list of all locally-advertised resources.
The following flags are available:
-r Restricts access to the resource to a read-only basis.
The default is read-write access.
-d description Provides brief textual information about the advertised
resource. description is a single argument surrounded by
double quotes (") and has a maximum length of 32
characters.
resource This is the symbolic name used by the server and all
authorized clients to identify the resource. It is
limited to a maximum of 14 characters and must be
different from every other resource name in the domain.
All characters must be displayable ASCII characters but
must not include dots (.), slashes (/), or white space.
pathname This is the local pathname of the advertised resource.
It is limited to a maximum of 64 characters. This
2/94 - Intergraph Corporation 1
adv(8) CLIX adv(8)
pathname cannot be the mount point of a remote resource
and it can only be advertised under one resource name.
clients These are the names of all clients that are authorized to
remotely mount the resource. The default is that all
machines that can connect to the server are authorized to
access the resource. Valid input is of the form
nodename, domain.nodename, domain., or an alias that
represents a list of client names. A domain name must be
followed by a dot (.) to distinguish it from a hostname.
The aliases are defined in /etc/host.alias and must
conform to the alias capability in mailx.
-m resource This flag modifies information for a resource that has
already been advertised. The resource is identified by a
resource name. Only the clients and description fields
can be modified. (To change the pathname, resource name,
or read/write permissions, you must unadvertise and re-
advertise the resource.)
When used with no flags, adv displays all local resources that have been
advertised; this includes the resource name, the pathname, the
description, the read-write status, and the list of authorized clients.
The resource field has a fixed length of 14 characters; all others are of
variable length. Fields are separated by two white spaces, double quotes
(") surround the description, and blank lines separate each resource
entry.
This command may be used without flags by any user; otherwise it is
restricted to the superuser.
Remote File Sharing must be running before adv can be used to advertise or
modify a resource entry.
EXIT STATUS
If there is at least one syntactically valid entry in the clients field, a
warning will be issued for each invalid entry and the command will return
a successful exit status. A nonzero exit status will be returned if the
command fails.
DIAGNOSTICS
If (1) the network is not up and running, (2) pathname is not a directory,
(3) pathname isn't on a file system mounted locally, or (4) there is at
least one entry in the clients field but none are syntactically valid, an
error message will be sent to stderr.
FILES
/etc/host.alias
2 Intergraph Corporation - 2/94
adv(8) CLIX adv(8)
RELATED INFORMATION
Commands: mount(1), rfstart(8), unadv(8), mailx(1)
2/94 - Intergraph Corporation 3