Maintenance Commands                                 mapuname(1m)

NAME
     mapuname - maps and unmaps PC NetLink user names to and from
     UNIX system user names.

SYNOPSIS
     mapuname [-I instance] [[-d] domain:username | UNIXusername]
     mapuname [-I instance] -a domain:username UNIXusername
     mapuname [-I instance] -p

DESCRIPTION
     The mapuname command is used to map the name of a PC NetLink
     user  to the name of a UNIX system user.  After a PC NetLink
     user has been mapped to the name of a UNIX user  on  a  UNIX
     system, whenever that PC NetLink user creates a file on that
     UNIX system, the UNIX system owner of that file will be that
     UNIX  system  user.   By default, all but a small predefined
     set of PC NetLink user names are mapped  implicitly  to  the
     UNIX  system  user lmworld.  Any mappings created explicitly
     using the mapuname command override this default mapping.

     Without arguments, the mapuname command displays all  expli-
     cit  mappings  that  are maintained by the system.  Given an
     argument domain:username,  the mapuname command displays the
     UNIX  user  name to which the indicated PC NetLink user name
     is mapped; the specified user name must be  defined  in  the
     local  or in a trusted domain. Given an argument in the form
     UNIXusername, the mapuname command displays all  PC  NetLink
     user names which map to the indicated UNIX user name.  It is
     possible to map multiple PC NetLink user names to a particu-
     lar UNIX user name.

     UNIX system user accounts also can be created  and  assigned
     automatically to PC NetLink user accounts.  For information,
     see the PC NetLink System Guide.

OPTIONS
  -I instance
     Specifies the PCNL instance name  or  number.  In  a  multi-
     instance environment instance may be specified either on the
     command line or by the environment  variable  PCNL_INSTANCE.
     If  there  is only one instance configured, it is not neces-
     sary to specify this argument.

  -d
     Deletes the specified mapping or mappings.

  -a
     Maps the specified PC NetLink user in  the  local  or  in  a
     trusted  domain  to  the  UNIX system user name on this com-
     puter. The specified PC NetLink user must exist.   The  UNIX
     system user name does not need to exist at the time that the
     command is run.

  -p
     Purges all obsolete mappings of PC  NetLink  user  names  to
     UNIX  system  user  names.  A mapping is considered obsolete
     either if the PC NetLink user name being mapped  or  if  the
     UNIX system user to which it is mapped does not exist.

EXAMPLES
     To map the PC NetLink user myname in the domain mydom to the
     UNIX  system  user uuname, type the following command at the
     UNIX system console where the UNIX  system  user  uuname  is
     defined:

          mapuname -a mydom:myname uuname
     To unmap the PC NetLink user myname  in  the  domain  mydom,
     type the following command at the UNIX system console:

          mapuname -d mydom:myname
     To delete all mappings of PC NetLink mapuname.1m user  names
     to  the  UNIX system user uuname, type the following command
     at the UNIX system console:

          mapuname -d uuname