projadd(1M) System Administration Commands projadd(1M)NAMEprojadd - administer a new project on the system
SYNOPSISprojadd [-n] [-f filename] [-p projid [-o]] [-c comment]
[-U user [,user]... ] [-G group [,group]... ]
[ [-K name [=value [,value]...]...]] project
DESCRIPTIONprojadd 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 com‐
mand.
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 parenthe‐
ses 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 parenthe‐
ses with double quotes, as shown above and
in EXAMPLES, below. See resource_con‐
trols(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 modifica‐
tions only. The contents of the existing
project file, such as user names, group
names, and resources that are specified in
the project attributes are not checked.
-o This option allows the project ID speci‐
fied 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 lim‐
its.h. projid defaults to the next avail‐
able unique number above the highest num‐
ber 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 project operand is a
string consisting of characters 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 restrictions 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 attributes:
┌────────────────────────────────────────────────────────┬──────────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────────────────────────────────────────┼──────────────────────────────────┤
│Availability │ system/extended-system-utilities │
├────────────────────────────────────────────────────────┼──────────────────────────────────┤
│Interface Stability │ See below. │
└────────────────────────────────────────────────────────┴──────────────────────────────────┘
Invocation is evolving. Human readable output is unstable.
SEE ALSOprojects(1), groupadd(1M), groupdel(1M), groupmod(1M), grpck(1M), pro‐
jdel(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 net‐
work 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.
SunOS 5.11 30 Sep 2004 projadd(1M)