ADV(1M) (Remote File Sharing Utilities) ADV(1M)
NAME
adv - advertise 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
adv 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(1M).] (A resource
represents a directory, which could contain files,
subdirectories, named pipes and devices.)
There are three ways adv is used: 1) to advertise the
directory pathname under the name resource so it is
available to Remote File Sharing clients; 2) to modify
client and description fields for currently advertised
resources; or 3) to print a list of all locally-advertised
resources.
The following options 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
Page 1 May 1989
ADV(1M) (Remote File Sharing Utilities) ADV(1M)
other resource name in the domain. All
characters must be printable ASCII characters
but must not include periods (.), slashes
(/), or white space.
pathname This is the local pathname of the advertised
resource. It is limited to a maximum of 64
characters. This 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
period (.) to distinguish it from a host
name. The aliases are defined in
/etc/host.alias and must conform to the alias
capability in mailx(1).
-m This option 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 options, 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
Page 2 May 1989
ADV(1M) (Remote File Sharing Utilities) ADV(1M)
separate each resource entry.
This command may be used without options by any user;
otherwise it is restricted to the super-user.
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 non-zero exit status will be returned if the command
fails.
ERRORS
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 standard error.
FILES
/etc/host.alias
SEE ALSO
mount(1M), rfstart(1M), unadv(1M).
mailx(1) in the User's Reference Manual.
Page 3 May 1989