Provided by: gridengine-common_6.2u5-3ubuntu1_all bug

NAME

       user - Sun Grid Engine user entry file format

DESCRIPTION

       A  user  entry  is  used to store ticket and usage information on a per
       user basis. Maintaining user entries for all users participating  in  a
       Sun Grid Engine system is required if Sun Grid Engine is operated under
       a user share tree policy.

       If the enforce_user cluster configuration parameter is set to  auto,  a
       user  object  for  the  submitting  user  will be created automatically
       during  job  submission,  if  one   does   not   already   exist.   The
       auto_user_oticket,   auto_user_fshare,  auto_user_default_project,  and
       auto_user_delete_time cluster configuration parameters will be used  as
       default attributes of the new user object.

       A  list  of  currently configured user entries can be displayed via the
       qconf(1) -suserl option. The contents of each enlisted user  entry  can
       be  shown  via  the  -suser  switch. The output follows the user format
       description. New user entries  can  be  created  and  existing  can  be
       modified via the -auser, -muser and -duser options to qconf(1).

       Note,  Sun Grid Engine allows backslashes (\) be used to escape newline
       (\newline) characters. The backslash and the newline are replaced  with
       a space (" ") character before any interpretation.

FORMAT

       A user entry contains four parameters:

   name
       The user name as defined for user_name in sge_types(1).

   oticket
       The amount of override tickets currently assigned to the user.

   fshare
       The current functional share of the user.

   default_project
       The default project of the user.

   delete_time
       Note: Deprecated, may be removed in future release.
       The  wall-clock  time  when this user will be deleted, expressed as the
       number of seconds elapsed since January 1, 1970. If set  to  zero,  the
       affected  user  is  a permanent user. If set to one, the user currently
       has  active  jobs.   For  additional  information  about  automatically
       created   users,   see   the   enforce_user  and  auto_user_delete_time
       parameters in sge_conf(5).

SEE ALSO

       sge_intro(1), sge_types(1), qconf(1).  sge_conf(5).

COPYRIGHT

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