USERMAPPING(5)							File Formats Manual						    USERMAPPING(5)

NAME

       usermapping - user mapping entry file format

DESCRIPTION

       A  usermapping entry is used to define alias names for a cluster user. The user's name known by the scheduling system is known as the clus-
       ter user. If the cluster user doesn't match the user account name on an execution host, the usermapping feature can solve the problem.

       Each line in the usermapping entry file specifies a user name and the host(s) where he has an account.

       A list of currently configured user mapping entries can be displayed via the qconf(1) -sumapl option. The contents of  each  enlisted  user
       mapping	entry  can  be shown via the -sumap switch. The output follows the usermapping format description. New user entries can be created
       and existing can be modified via the -aumap, -mumap and -dumap options to qconf(1).

FORMAT

       A user mapping entry contains two parameters:

   cluster_user
       The cluster_user keyword defines the cluster user name. The rest of the textline after the keyword "cluster_user" will be taken as  cluster
       user value.

   remote_user
       The  user  name on an execution host. Please note that the value for this attribute might be overwritten for a certain hostgroups or single
       host.  Find an example below.

EXAMPLE

       This is a typical user mapping entry for a cluster user mapping:

       cluster_user   peter

       remote_user    peter,[@linux=pet1],[fangorn=peter1]

       The entry will map the user peter which is defined in the cluster system to the user peter on all hosts in the cluster except for all hosts
       which  are  referenced  in  the hostgroup @linux. For all these hosts the user will be mapped to pet1. For the host fangorn the remote user
       will be peter1.	hostgroup(5) to obtain for more information about that.

SEE ALSO

       qconf(1), hostgroup(5).

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.

								      $Date$							    USERMAPPING(5)