unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

ADV(8)                      System Manager's Manual                     ADV(8)



NAME
       adv - advertise a directory for remote access with RFS

SYNOPSIS
       adv
       adv [ -r ] [ -d description ] resource pathname [ clients ...]
       adv -m resource -d description| [ clients...  ]
       adv -m resource [ -d description ] | clients ...

AVAILABILITY
       This  program  is  available with the RFS software installation option.
       Refer to for information on how to install optional software.

DESCRIPTION
       adv makes a resource from one system available for use  on  other  sys-
       tems.   The  machine that advertises the resource is called the server,
       while systems that  mount  and  use  the  resource  are  clients.   See
       mount(8).   resource represents a directory, which could contain files,
       subdirectories, named pipes and devices.

       Remote File Sharing (RFS) must be running before adv  can  be  used  to
       advertise or modify a resource entry.

       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 SPACE characters and
       double quotes (") surround the description.

       This command may be used without options by any user; otherwise  it  is
       restricted to the super-user.

       There are three ways adv is used:

              o  To print a list of all locally-advertised resources, as shown
                 by the first synopsis.

              o  To advertise the directory pathname under the  name  resource
                 so  it  is  available  to RFS clients, as shown by the second
                 synopsis.

              o  To modify client and description fields for currently  adver-
                 tised resources, as shown by the third and fourth synopses.

       If  any  of  the  following  are true, an error message will be sent to
       standard error.

              o  The network is not up and running.

              o  pathname is not a directory.

              o  pathname is not on a file system mounted locally.

              o  There is at least one entry in the clients field but none are
                 syntactically valid.

OPTIONS
       -r             Restrict  access  to  the resource to a read-only basis.
                      The default is read-write access.

       -d description Provide brief textual information about  the  advertised
                      resource.   description  is a single argument surrounded
                      by double quotes ("argument") and has a  maximum  length
                      of 32 characters.

       -m resource    Modify  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.

       resource       This is the symbolic name used by  the  server  and  all
                      authorized clients to identify the resource.  It is lim-
                      ited to a maximum of 14 characters and must be different
                      from every other resource name in the domain.  All char-
                      acters 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 path-
                      name  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 `.'  to  distinguish  it  from  a  host
                      name.   The  aliases  are defined in /etc/host.alias and
                      must conform to the alias capability in mail(1).

EXAMPLES
       The following example displays  the  local  resources  that  have  been
       advertised:
              example% adv
              LOCAL_SUN3      /export/local/sun3  ""  read-only unrestricted
              LOCAL_SUN4      /export/local/sun4  ""  read-only unrestricted
              LOCAL_SHARE     /export/local/share  ""  read-only unrestricted

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.

FILES
       /etc/host.alias

SEE ALSO
       mount(8), rfstart(8), unadv(8)



                                 30 June 1988                           ADV(8)