summaryrefslogtreecommitdiff
path: root/usr/src/man/man1m/projmod.1m
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1m/projmod.1m')
-rw-r--r--usr/src/man/man1m/projmod.1m83
1 files changed, 14 insertions, 69 deletions
diff --git a/usr/src/man/man1m/projmod.1m b/usr/src/man/man1m/projmod.1m
index 17d0e007a1..81a6e13a15 100644
--- a/usr/src/man/man1m/projmod.1m
+++ b/usr/src/man/man1m/projmod.1m
@@ -3,7 +3,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH projmod 1M "22 Feb 2007" "SunOS 5.11" "System Administration Commands"
+.TH PROJMOD 1M "Feb 22, 2007"
.SH NAME
projmod \- modify a project's information on the system
.SH SYNOPSIS
@@ -14,10 +14,10 @@ projmod \- modify a project's information on the system
.LP
.nf
-\fBprojmod\fR [\fB-n\fR] [\fB-A\fR|\fB-f\fR \fIfilename\fR | -] [\fB-p\fR \fIprojid\fR [\fB-o\fR]]
- [\fB-c\fR \fIcomment\fR] [\fB-a\fR|\fB-s\fR|\fB-r\fR] [\fB-U\fR \fIuser\fR [,\fIuser\fR]... ]
- [\fB-G\fR \fIgroup\fR [,\fIgroup\fR]... ]
- [ [\fB-K\fR \fIname\fR [=\fIvalue\fR [,\fIvalue\fR]...]...]]
+\fBprojmod\fR [\fB-n\fR] [\fB-A\fR|\fB-f\fR \fIfilename\fR | -] [\fB-p\fR \fIprojid\fR [\fB-o\fR]]
+ [\fB-c\fR \fIcomment\fR] [\fB-a\fR|\fB-s\fR|\fB-r\fR] [\fB-U\fR \fIuser\fR [,\fIuser\fR]... ]
+ [\fB-G\fR \fIgroup\fR [,\fIgroup\fR]... ]
+ [ [\fB-K\fR \fIname\fR [=\fIvalue\fR [,\fIvalue\fR]...]...]]
[\fB-l\fR \fInew_projectname\fR] \fIproject\fR
.fi
@@ -33,24 +33,20 @@ appropriate project-related system file and file system changes.
The following options are supported:
.sp
.ne 2
-.mk
.na
\fB\fB-A\fR\fR
.ad
.RS 29n
-.rt
Apply the project's resource controls, as defined in the system's project
database, to the project if it is active.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-a\fR\fR
.ad
.RS 29n
-.rt
Specify that the users, groups, attributes, or attribute values specified by
the \fB-U\fR, \fB-G\fR or \fB-K\fR options should be added to the project,
rather than replacing the existing member or attribute list.
@@ -58,12 +54,10 @@ rather than replacing the existing member or attribute list.
.sp
.ne 2
-.mk
.na
\fB\fB-c\fR \fIcomment\fR\fR
.ad
.RS 29n
-.rt
Specify \fIcomment\fR as a text string. Generally, \fIcomment\fR contains a
short description of the project. This information is stored in the project's
\fB/etc/project\fR entry.
@@ -71,12 +65,10 @@ short description of the project. This information is stored in the project's
.sp
.ne 2
-.mk
.na
\fB\fB-f\fR \fIfilename\fR | -\fR
.ad
.RS 29n
-.rt
Specify the project file to modify or validate or specify input from stdin for
validation. As noted under OPERANDS, if you do not specify a project in a
\fBprojmod\fR command line, \fBprojmod\fR validates the argument to \fB-f\fR.
@@ -86,12 +78,10 @@ modified.
.sp
.ne 2
-.mk
.na
\fB\fB-G\fR \fIgroup\fR [,\fIgroup\fR...]\fR
.ad
.RS 29n
-.rt
Specify a replacement list of member groups of the project. When used in
conjunction with the \fB-a\fR or \fB-r\fR options, this option specifies a list
of groups to be added or removed from the project.
@@ -99,12 +89,10 @@ of groups to be added or removed from the project.
.sp
.ne 2
-.mk
.na
\fB\fB-K\fR \fIname\fR[=\fIvalue\fR[,\fIvalue\fR...]\fR
.ad
.RS 29n
-.rt
Specify a replacement list of project attributes for the project. When used in
conjunction with the \fB-a\fR, \fB-r\fR, or \fB-s\fR options, this option
specifies a list of attribute values to be added, removed, or replaced in the
@@ -127,12 +115,10 @@ for a description of the resource controls you can specify for a project.
.sp
.ne 2
-.mk
.na
\fB\fB-l\fR \fInew_projectname\fR\fR
.ad
.RS 29n
-.rt
Specify the new project name for the project. The \fInew_projectname\fR
argument is a string consisting of characters from the set of alphabetic
characters, numeric characters, period (\fB\&.\fR), underline (\fB_\fR), and
@@ -143,12 +129,10 @@ within the project file.
.sp
.ne 2
-.mk
.na
\fB\fB-n\fR\fR
.ad
.RS 29n
-.rt
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 attributes
@@ -157,24 +141,20 @@ are not checked.
.sp
.ne 2
-.mk
.na
\fB\fB-o\fR\fR
.ad
.RS 29n
-.rt
This option allows the project ID specified by the \fB-p\fR option to be
non-unique within the project file.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-p\fR \fIprojid\fR\fR
.ad
.RS 29n
-.rt
Specify a new project \fBID\fR for the project. It must be a non-negative
decimal integer less than \fBMAXUID\fR as defined in \fBparam.h\fR. This value
must be unique within the project file if the \fB-o\fR option is not specified.
@@ -182,12 +162,10 @@ must be unique within the project file if the \fB-o\fR option is not specified.
.sp
.ne 2
-.mk
.na
\fB\fB-r\fR\fR
.ad
.RS 29n
-.rt
Specify that the users, groups, attributes, or attribute values specified by
the \fB-U\fR, \fB-G\fR or \fB-K\fR options should be removed from the project,
rather than replacing the existing member or attribute list.
@@ -195,12 +173,10 @@ rather than replacing the existing member or attribute list.
.sp
.ne 2
-.mk
.na
\fB\fB-s\fR\fR
.ad
.RS 29n
-.rt
Specify that the list of attributes specified by the \fB-K\fR option should
have their values replaced. If the attributes do not exist, they are added as
if the a option was used. This option has no effect the \fB-U\fR or \fB-G\fR
@@ -209,12 +185,10 @@ options.
.sp
.ne 2
-.mk
.na
\fB\fB-U\fR \fIuser\fR [,\fIuser\fR...]\fR
.ad
.RS 29n
-.rt
Specify a replacement list of member users of the project. When used in
conjunction with the \fB-a\fR or \fB-r\fR options, this option specifies a list
of users to be added or removed from the project.
@@ -226,23 +200,19 @@ of users to be added or removed from the project.
The following operands are supported:
.sp
.ne 2
-.mk
.na
\fB\fIproject\fR\fR
.ad
.RS 11n
-.rt
An existing project name to be modified or displayed.
.RE
.sp
.ne 2
-.mk
.na
\fB\fI(none)\fR\fR
.ad
.RS 11n
-.rt
If no operand is given, the project file is validated without modifying any
project.
.RE
@@ -289,7 +259,7 @@ entry:
.sp
.in +2
.nf
-# projmod -a -K "task.max-lwps=(priv,100,deny)" salesaudit
+# projmod -a -K "task.max-lwps=(priv,100,deny)" salesaudit
.fi
.in -2
@@ -327,7 +297,7 @@ the command for the action clauses in the preceding entry:
.sp
.in +2
.nf
-# projmod -s -K "task.max-lwps=(priv,500,signal=SIGSTOP)" salesaudit
+# projmod -s -K "task.max-lwps=(priv,500,signal=SIGSTOP)" salesaudit
.fi
.in -2
@@ -364,7 +334,7 @@ preceding entry:
.sp
.in +2
.nf
-# projmod -r -K "task.max-lwps=(priv,100,deny)" salesaudit
+# projmod -r -K "task.max-lwps=(priv,100,deny)" salesaudit
.fi
.in -2
@@ -403,7 +373,7 @@ The following \fBprojmod\fR command adds these resource controls for
.in +2
.nf
# projmod -a -K "task.max-lwps=(priv,100,deny)" \e
--K "process.max-file-size=(priv,50MB,deny)" salesaudit
+-K "process.max-file-size=(priv,50MB,deny)" salesaudit
.fi
.in -2
@@ -486,134 +456,110 @@ of the following values:
The following exit values are returned:
.sp
.ne 2
-.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
-.rt
Successful completion.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB2\fR\fR
.ad
.RS 6n
-.rt
The command syntax was invalid. A usage message for \fBprojmod\fR is displayed.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB3\fR\fR
.ad
.RS 6n
-.rt
An invalid argument was provided to an option.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB4\fR\fR
.ad
.RS 6n
-.rt
The \fIprojid\fR given with the \fB-p\fR option is already in use.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB5\fR\fR
.ad
.RS 6n
-.rt
The project files contain an error. See \fBproject\fR(4).
.RE
.sp
.ne 2
-.mk
.na
\fB\fB6\fR\fR
.ad
.RS 6n
-.rt
The project to be modified, group, user, or resource does not exist.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB9\fR\fR
.ad
.RS 6n
-.rt
The project is already in use.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB10\fR\fR
.ad
.RS 6n
-.rt
Cannot update the \fB/etc/project\fR file.
.RE
.SH FILES
.sp
.ne 2
-.mk
.na
\fB\fB/etc/group\fR\fR
.ad
.RS 16n
-.rt
System file containing group definitions
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/etc/project\fR\fR
.ad
.RS 16n
-.rt
System project file
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/etc/passwd\fR\fR
.ad
.RS 16n
-.rt
System password file
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/etc/shadow\fR\fR
.ad
.RS 16n
-.rt
System file containing users' encrypted passwords and related information
.RE
@@ -625,13 +571,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.TS
-tab() box;
-cw(5.5i) |cw(0i)
-lw(5.5i) |lw(0i)
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
+box;
+c | c
+l | l .
+ATTRIBUTE TYPE ATTRIBUTE VALUE
_
-Interface StabilitySee below.
+Interface Stability See below.
.TE
.sp