NETUNAM(2)                                             NETUNAM(2)

     NAME
          netunam  -  set up authentication  for  remote  file  system
          access

     SYNOPSIS
          int netunam (path, string)
          char *path, *string;

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

          Origin:   HP

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

          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.

          The login information is  sent  to  the  remote  system  for
          immediate  verification.  It is used for the duration of the
          process to determine access rights for all file accesses  to
          that  system.   The  authentication  information  is  passed
          across fork(2) and exec(2) calls.  Only  one  authentication
          can  remain  in effect per network special file per process.
          The authentication  information  is  changed  by  subsequent
          netunam calls with the same path.

          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.

     RETURN VALUE
          Upon successful  completion,  a  value  of  0  is  returned.
          Otherwise,  a  value  of  -1 is returned and errno is set to

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

     NETUNAM(2)                                             NETUNAM(2)

          indicate the error.

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

     DIAGNOSTICS

          [EFAULT]         Path points outside the process's allocated
                           address space.

          [ENOENT]         File specified by path does not exist.

          [EISDIR]         File specified by path is a directory,  not
                           a network special file.

          [ENOTDIR]        File specified by path  is  not  a  network
                           special file.

          [ENET]           A  network  error  occurred.  The  external
                           variable  errnet  is  set  to  one  of  the
                           following network error values:

          [NE_NOLOGIN]            Login information is invalid.

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