Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

projadd


NAME
     projadd - administer a new project on the system

SYNOPSIS
     projadd [-n] [-f filename] [-p projid   [-o]]  [-c  comment]
     [-U  user  [,user...] ] [-G group  [,group...] ] [  [-K name
     [=value [,value...]...]]] project

DESCRIPTION
     projadd adds a new project entry to the  /etc/project  file.
     If the files backend is being used for the project database,
     the new project is available for use  immediately  upon  the
     completion of the projadd command.

OPTIONS
     The following options are supported:

     -c comment

         Add a  project  comment.  Comments  are  stored  in  the
         project's  entry  in  the  /etc/project file. Generally,
         comments contain a short description of the project  and
         are used as the field for the project's full name.

         Specify comment as a text string. comment cannot contain
         a colon (:) or <NEWLINE>.



     -f filename

         Specify the project file to modify. If  no  filename  is
         specified,  the  system  project  file, /etc/project, is
         modified.



     -G group[,group...]

         Specify a group list for the project.



     -K name[=value[,value...]

         Specify an attribute list for the project.  Multiple  -K
         options can be specified to set values on multiple keys,
         such as:


         -K key1=value1 -K "key2=(value2a),(value2b)"

         Resource control attributes use parentheses  to  specify
         values  for  a  key.  Because many user shells interpret
         parentheses as special characters, it is best to enclose
         an  argument to -K that contains parentheses with double
         quotes, as shown  above  and  in  EXAMPLES,  below.  See
         resource_controls(5)  for  a description of the resource
         controls you can specify for a project.



     -n

         Syntax check. Check the format of  the  existing  system
         project file and modifications only. The contents of the
         existing project file, such as user names, group  names,
         and  resources  that are specified in the project attri-
         butes are not checked.



     -o

         This option allows the project ID specified  by  the  -p
         option to be non-unique within the project file.



     -p projid

         Set the project ID of the new project.

         Specify projid as a non-negative decimal  integer  below
         UID_MAX  as  defined in limits.h. projid defaults to the
         next available unique number above  the  highest  number
         currently  assigned.  For  example, if projids 100, 105,
         and 200 are assigned, the next default  projid  is  201.
         projids between 0-99 are reserved by SunOS.



     -U user[,user...]

         Specify a user list for the project.



OPERANDS
     The following operands are supported:

     project         The name of the project to create. The  pro-
                     ject operand is a string consisting of char-
                     acters   from   the   set   of    alphabetic
                     characters,  numeric  characters,  underline
                     (_), and hyphen (-).  The  period  ('.')  is
                     reserved  for  projects with special meaning
                     to the operating system. The first character
                     of  the  project  name  must be a letter. An
                     error message is displayed if these restric-
                     tions are not met.



EXAMPLES
     Example 1: Adding a Project

     The following command creates  the  project  salesaudit  and
     sets  the resource controls specified as arguments to the -K
     option.

     projadd -p 111 -G sales,finance -c "Auditing Project" \
        -K "rcap.max-rss=10GB" \
        -K "process.max-file-size=(priv,50MB,deny)" \
        -K "task.max-lwps=(priv,100,deny)" salesaudit


     This  command  would  produce   the   following   entry   in
     /etc/project:

     salesaudit:111:Auditing Project::sales,finance: \
     process.max-file-size=(priv,52428800,deny); \
     rcap.max-rss=10737418240;task.max-lwps=(priv,100,deny)


     Note  that  the  preceding  would  appear  as  one  line  in
     /etc/project.

     Comparing  the  projadd  command  and  resulting  output  in
     /etc/project,  note  the effect of the scaling factor in the
     resource cap (rcap.max-rss=10GB) and  the  resource  control
     (process.max-file-size=(priv,50MB,deny)). Modifiers, such as
     B,  KB,  and  MB,  and  scaling  factors  are  specified  in
     resource_controls(5).

EXIT STATUS
     The following exit values are returned:

     0        Successful completion.



     2        The command syntax was invalid. A usage message for
              projadd is displayed.


     3        An invalid argument was provided to an option.



     4        The projid given with the -p option is  already  in
              use.



     5        The project files contain an error. See project(4).



     6        The project to be added, group, user,  or  resource
              does not exist.



     9        The project is already in use.



     10       Cannot update the /etc/project file.



FILES
     /etc/project            System project file



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |        ATTRIBUTE TYPE        |       ATTRIBUTE VALUE      |
    |______________________________|____________________________|
    | Availability                 |  SUNWesu                   |
    |______________________________|____________________________|
    | Interface Stability          |  See below.                |
    |______________________________|____________________________|


     Invocation is evolving. Human readable output is unstable.

SEE ALSO
     projects(1),   groupadd(1M),   groupdel(1M),   groupmod(1M),
     grpck(1M),     projdel(1M),     projmod(1M),    useradd(1M),
     userdel(1M),   usermod(1M),    project(4),    attributes(5),
     resource_controls(5)

NOTES
     In case of an error, projadd prints  an  error  message  and
     exits with a non-zero status.

     projadd adds a project definition only on the local  system.
     If  a network name service such as NIS or LDAP is being used
     to supplement the local /etc/project  file  with  additional
     entries,  projadd  cannot change information supplied by the
     network name service.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments