project

 

---

 
 
 
 File Formats                                           project(4)
 
 
 


NAME
      project - project file
 


DESCRIPTION
      The project file is a local source of  project  information.
      The  project file can be used in conjunction with other pro-
      ject sources, including  the  NIS  maps  project.byname  and
      project.bynumber and the LDAP database project. Programs use
      the getprojent(3EXACCT) routines to access this information.
 
      The project file contains a one-line entry for each  project
      recognized by the system, of the form:
 
      projname:projid:comment:user-list:group-list:attributes
 
      where the fields are defined as:
 
      projname
            The name of the project. Allowable project names  must
            begin with a letter, and may be composed of any letter
            or digit and  the  underscore  character.  The  period
            ('.') is reserved for projects with special meaning to
            the operating system.
 
      projid
            The project's unique numerical ID (PROJID) within  the
            system.
 
      comment
            The project's description.
 
      user-list
            A comma-separated list of users allowed  in  the  pro-
            ject.
 
      group-list
            A comma-separated list of groups of users  allowed  in
            the project.
 
      attributes
            A semicolon-separated list of name value  pairs.  Each
            pair has the following format:
 
            name[=value]
 
            where name is  the  arbitrary  string  specifying  the
            key's  name  and  value  is the optional key value. An
            explanation of the valid  name-value  pair  syntax  is
            provided  in  the  USAGE  section  of  this  page. The
            expected most frequent use of the attribute  field  is
            for the specification of resource controls.
 
 
 
 
 SunOS 5.8            Last change: 3 Oct 2001                    1
 
 
 
 
 
 
 File Formats                                           project(4)
 
 
 
      The maximum value of the projid field is MAXPROJID.
 
      Malformed entries cause routines  that  read  this  file  to
      halt,  in  which  case project assignments specified further
      along are never made. Blank lines are treated  as  malformed
      entries    in    the    project   file,   and   will   cause
      getprojent(3EXACCT) and derived interfaces to fail.
 
 EXAMPLES
      Example 1: Sample project File
 
      The following is a sample project file:
 
      system:0:System:::
      user.root:1:Super-User:::
      noproject:2:No Project:::
      default:3::::
      group.staff:10::::
      beatles:100:The Beatles:john,paul,george,ringo::task.max-lwps=
          (privileged,100,signal=SIGTERM),(privileged,110,deny)
 
      Note that the line break in the line that begins  with  bea-
      tles  is  not valid in a project file. It is shown here only
      to allow the example to display on a  printed  or  displayed
      page. Each entry must be on one and only one line.
 
      An example project entry for nsswitch.conf(4) is:
 
      project: files nis
 
      With these entries, the project beatles  will  have  members
      john,  paul,  george,  and ringo, and all projects listed in
      the NIS project table are effectively incorporated after the
      entry for beatles.
 
      The beatles project has two values set on the  task.max-lwps
      resource  control.  When  a  task  in  the  beatles  project
      requests (via one of its member  processes)  its  100th  and
      110th LWPs, an action associated with the encountered thres-
      hold triggers.  Upon the request for the 100th LWP, the pro-
      cess  making  the  request is sent the signal SIGTERM and is
      granted the request for an  additional  lightweight  process
      (LWP). At this point, the threshold for 110 LWPs becomes the
      active threshold. When a request for the 110th  LWP  in  the
      task  is made, the requesting process is denied the request-
      -no LWP will be  created.  Since  the  110th  LWP  is  never
      granted,  the  threshold  remains active, and all subsequent
      requests for an 110th LWP will fail. (If LWPs are given  up,
      then  subsequent  requests  will  succeed, unless they would
      take the total number of LWPs across the task over 110.)
 
 
 
 
 
 SunOS 5.8            Last change: 3 Oct 2001                    2
 
 
 
 
 
 
 File Formats                                           project(4)
 
 
 
 USAGE
      The project database offers a reasonably flexible  attribute
      mechanism  in  the  final  name-value pair field. Name-value
      pairs are separated from one another with the semicolon  (;)
      character.  The  name  is  in  turn  distinguished  from the
      (optional) value by the equals  (=)  character.   The  value
      field can contain multiple values separated by the comma (,)
      character, with grouping support (into further values lists)
      by  parentheses. Each of these values can be composed of the
      upper and lower case alphabetic characters, the  digits  '0'
      through '9', and the punctuation characters hyphen (-), plus
      (+), period (.), slash  (/),  and  underscore  (_).  Example
      resource  control value specifications are provided in EXAM-
      PLES, above, and on the getprojent(3PROJECT) manual page.
 


SEE ALSO
      newtask(1), projects(1), getprojent(3EXACCT), unistd(3HEAD),
      nsswitch.conf(4)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8            Last change: 3 Oct 2001                    3
 
 
 

---