USERMAPPING(5)                                                  USERMAPPING(5)



NNAAMMEE
       usermapping - user mapping entry file format

DDEESSCCRRIIPPTTIIOONN
       A  usermapping  entry is used to define alias names for a cluster user.
       The user's name known by the scheduling system is called cluster  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 _q_c_o_n_f(1) --ssuummaappll option. The contents  of  each  enlisted  user
       mapping  entry  can  be shown via the --ssuummaapp switch. The output follows
       the _u_s_e_r_m_a_p_p_i_n_g format description. New user entries can be created and
       existing  can  be modified via the --aauummaapp, --mmuummaapp and --dduummaapp options to
       _q_c_o_n_f(1).

FFOORRMMAATT
       A user mapping entry contains two parameters:

       cclluusstteerr__uusseerr
              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.


       rreemmoottee__uusseerr
              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.



EEXXAAMMPPLLEE
       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  sys-
       tem  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.  _h_o_s_t_g_r_o_u_p(5) to obtain for more information about that.



SSEEEE AALLSSOO
       _q_c_o_n_f(1), _h_o_s_t_g_r_o_u_p(5).

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



                         $Date: 2004/04/22 08:51:04 $           USERMAPPING(5)
