rfadmin(8)                          CLIX                          rfadmin(8)



  NAME

    rfadmin - Runs Remote File Sharing administration

  SYNOPSIS

    rfadmin

    rfadmin -[ar] domain.nodename

    rfadmin -[pq]

    rfadmin -o option

  FLAGS

    -a domain.nodename
           Used to add a computer to the member list of the domain that is
           served by this primary domain name server.  The computer's name
           must be of the form domain.nodename.  This command creates an entry
           for nodename in the domain/passwd file, which has the same format
           as /etc/passwd, and prompts for an initial authentication password.
           The password prompting process conforms with that of passwd(1).

    -r domain.nodename
           Used to remove a computer from its domain by removing it from the
           domain/passwd file.

    -p     Used to pass the domain name server responsibilities back to a
           primary or to a secondary name server.

    -q     Displays a message that will tell you whether or not Remote File
           Sharing (RFS) is running.

    -o option
           Lets you set RFS system options, by replacing option with one of
           the following:

           loopback     Enables loop-back facility for your computer.  When
                        this is set, you can mount a resource that is
                        advertised from your own computer.  This is used for
                        testing applications in RFS when only one computer is
                        available.  Loop back is off by default.

           noloopback   Turns off the loop-back facility for your computer.
                        This is the default.

  DESCRIPTION

    The rfadmin command is primarily used to add and remove computers and
    their associated authentication information from a domain/passwd file on a



  2/94 - Intergraph Corporation                                              1

  rfadmin(8)                          CLIX                          rfadmin(8)



    Remote File Sharing (RFS) primary domain name server.  It is also used to
    transfer domain name server responsibilities from one machine to another.
    When used with no flags, rfadmin returns the domain.nodename of the
    current domain name server for the local domain.  Other flags let you
    check if RFS is running and turn on the RFS loop-back feature.

    The rfadmin command can only be used to modify domain files on the primary
    domain name server (-a and -r flags).  If domain name server
    responsibilities are temporarily passed to a secondary domain name server,
    that computer can use the -p flag to pass domain name server
    responsibility back to the primary.  The rfadmin command can be used on
    any computer with no flags or with the -q or -o flags to display
    information about the current domain name server.  The user must have root
    permissions to use the command.

  EXAMPLES

    1.  The following example will add hostname fee, domain graph to the
        current domain:

        rfadmin -a graph.fee


    2.  This example removes hostname fee, domain graph from the current
        domain:

        rfadmin -r graph.fee


  FILES

    /usr/nserve/auth.info/domain/passwd
           For each domain, this file is created on the primary and should be
           copied to all secondaries and to all computers that want to do
           password verification of computers in the domain.

  DIAGNOSTICS

    When rfadmin is used with the -a flag, an error message will be sent to
    stderr if domain.nodename is not unique in the domain.

    When used with the -r flag, an error message will be sent to stderr if:

    ⊕  The domain.nodename does not exist in the domain

    ⊕  The domain.nodename is defined as a domain name server or

    ⊕  There are resources advertised by domain.nodename.

    When used with the -p flag to change the domain name server, a warning
    message will be sent to stderr if there are no backup name servers defined



  2                                              Intergraph Corporation - 2/94

  rfadmin(8)                          CLIX                          rfadmin(8)



    for domain.

  EXIT VALUES

    The rfadmin command will exit with a value of 1 if it encounters a
    problem.

  RELATED INFORMATION

    Commands: rfstart(8), rfstop(8), umount(8), passwd(1)












































  2/94 - Intergraph Corporation                                              3