NETUNAM(1)                                             NETUNAM(1)

     NAME
          netunam  -  set up authentication  string  for  remote  file
          system access

     SYNOPSIS
          netunam path  string

     HP-UX COMPATABILITY
          Level:    HP-UX/NON-STANDARD

          Origin:   HP

     DESCRIPTION
          Netunam sets up user authentication for  file  access  on  a
          particular   remote   HP-UX   system.   Requires  super-user
          capabilities.

          Path refers to a network special file which  identifies  the
          remote system. (In order to access files on a remote system,
          a network special file for the remote node must  exist.   It
          is  recommended that the name of the network special file be
          the same as the node name.)

          String  is  a  character  string  (up  to   64   characters)
          representing   the   user's  login  name  and  password  (if
          required) for the remote system.  A colon ( : ) is  used  to
          separate  the  login name from the password. If the password
          is omitted from string,  the  system  will  prompt  for  the
          password with the echo turned off.

          The login information is passed to the remote  HP-UX  system
          for  immediate  verification. It is used for the duration of
          the session to determine the access rights  for  all  remote
          file accesses to that system.

          Netunam is recognized and executed directly  by  the  shell.
          The  login information is passed on to all programs executed
          by the shell.

          Series 200 and 300 computers can have a maximum  of  20  RFA
          connections   per  process.  Connections  can  be  freed  by
          executing a netunam command with the  network  special  file
          for   the  computer  with  which  you  are  terminating  the
          connection and the empty string for the login.  For example,

             netunam /net/PC_design1 ""

          Series 500 computers do not have a limitation on connections
          per  process,  and  consequently,  have  no  command to free
          connections.

     EXAMPLES

     Hewlett-Packard               - 1 -             (printed 7/16/86)

     NETUNAM(1)                                             NETUNAM(1)

          A network special file /net/PC_Design1 must  be  created  to
          reference  a  node with the node name PC_Design1.  To create
          the network special file, enter:

             mknod /net/PC_Design1 n PC_Design1

          To obtain access to files which are legally accessible to  a
          user  with  login  name  john  and  password deadbolt on the
          system identified by the network  special  file  PC_Design1,
          enter:

             netunam /net/PC_Design1 john:deadbolt

          or enter:

             netunam /net/PC_Design1 john:

          The system prompts for the  password  with  the  local  echo
          turned off:

             password:

          Enter:

             deadbolt

     SEE ALSO
          login(1), mknod(1M), mknod(2), mknod(5), netunam(2), sh(1).

     Hewlett-Packard               - 2 -             (printed 7/16/86)