usermapping

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 users name known by the sheduling system is called cluster user. If
       the cluster name 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 at least tree parameters:

       cluster_user keyword
              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.


       name   The user name on an execution host.

       hostname
              The name of the host where the user specified in name has an
              account.  If The first character of the hostname is a "@" sign
              the name is used to reference a hostgroup(5).


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


       cluster_user office

       alice     wonderland, realworld, @office2

       The entry will map the user office which is defined in the cluster
       system to the user alice on the hosts wonderland and realworld.  The
       "@" sign is used to reference a host group. So the user office is
       mapped to alice on all hosts specified in the host group office2.
       Please see 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: 2001/07/20 08:19:16 $           USERMAPPING(5)