'\" 
.\" @(#)mapuname.1m	1.2 01 Oct 1998 SMI
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\" All Rights Reserved
.\" @(#)mapuname.rof	1.3 1/31/97
.TH mapuname 1m "18 Mar 1997"
.if n .tr \--
.SH NAME
mapuname - maps and unmaps SunLink Server user,
global group, and local group names to and from UNIX system user names.
.SH SYNOPSIS
.nf
.ft4
mapuname [[-d] domain:object | UNIXusername] 
mapuname -a domain:object UNIXusername 
mapuname -p
.SH DESCRIPTION
The mapuname command is used to map the name of a SunLink Server
object (user, global group, or local group) to the name of a UNIX
system user.  After a SunLink Server object has been mapped to the
name of a UNIX user on a UNIX system, whenever that SunLink Server
object 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 SunLink Server objects are mapped implicitly to the
UNIX system user lmworld.  Any mappings created explicitly using the
mapuname command override this default mapping.  
.sp.5
Without arguments, the mapuname command displays all explicit mappings
that are maintained by the system.  Given an argument 
domain:object,  the mapuname command displays the UNIX user name to
which the indicated SunLink Server object is mapped; the specified
object must be defined in the local or in a trusted domain.  
Given an argument in the
form UNIXusername, the mapuname command displays all SunLink Server
objects which map to the indicated UNIX user name.  It is possible to
map multiple SunLink Server objects to a particular UNIX user name;
however, each SunLink Server object maps to only one UNIX system user name.
.sp .5
UNIX system user accounts also can be created and assigned automatically to SunLink Server user accounts.  For information, see the SunLink Server
System Guide.
.SH OPTIONS
.SS -d
Deletes the specified mapping or mappings.
.SS -a
Maps the specified SunLink Server user, global group, or
local group in the local or in a trusted domain to the UNIX system 
user name on this computer.  
The specified SunLink Server user, global group, or
local group must exist.  The UNIX system user name does not need to
exist at the time that the command is run.
.SS -p
Purges all obsolete mappings of SunLink Server objects to 
UNIX system user names.  A mapping is considered obsolete 
either if the SunLink Server object being mapped or if
the UNIX system user to which it is mapped does not exist.
.SH EXAMPLES
To map the SunLink Server 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:
.sp.5
	mapuname -a mydom:myname uuname
.sp.5 
To unmap the SunLink Server user myname in the domain mydom,
type the following command at the UNIX system console:
.sp.5
	mapuname -d mydom:myname   
.sp.5
To delete all mappings of SunLink Server mapuname.1m objects to the UNIX system
user uuname, type the following command at the UNIX system console:
.sp.5
	mapuname -d uuname