summaryrefslogtreecommitdiff
path: root/usr/src/tools/pmodes/README.pmodes
diff options
context:
space:
mode:
authorRichard Lowe <richlowe@richlowe.net>2018-01-24 20:09:53 +0000
committerRichard Lowe <richlowe@richlowe.net>2018-01-27 21:42:10 +0000
commit498924fdb0b10437ef130a81beee94e710d55a5b (patch)
treec95f522bf42326b290a8624b181053b23bc22940 /usr/src/tools/pmodes/README.pmodes
parent5c60adfb7915647f372e2ddb0c4b967d3d03f779 (diff)
downloadillumos-joyent-498924fdb0b10437ef130a81beee94e710d55a5b.tar.gz
8991 pmodes is useless and can be deleted
Reviewed by: Toomas Soome <tsoome@me.com> Reviewed by: Peter Tribble <peter.tribble@gmail.com> Reviewed by: Andy Fiddaman <omnios@citrus-it.co.uk> Approved by: Dan McDonald <danmcd@joyent.com>
Diffstat (limited to 'usr/src/tools/pmodes/README.pmodes')
-rw-r--r--usr/src/tools/pmodes/README.pmodes119
1 files changed, 0 insertions, 119 deletions
diff --git a/usr/src/tools/pmodes/README.pmodes b/usr/src/tools/pmodes/README.pmodes
deleted file mode 100644
index da8152f1da..0000000000
--- a/usr/src/tools/pmodes/README.pmodes
+++ /dev/null
@@ -1,119 +0,0 @@
-#
-# CDDL HEADER START
-#
-# 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]
-#
-# CDDL HEADER END
-#
-
-#
-# Copyright 2010 Sun Microsystems, Inc. All rights reserved.
-# Use is subject to license terms.
-#
-
-Pmodes is a program that updates pkgmap files or pkg prototype files.
-
-
-
-Applicability:
-
-Use of pmodes has been deprecated in onnv-gate; instead, see
-validate_pkg, as delivered by developer/build/onbld, and
-exception_lists/pmodes.
-
-Other OSNet users (ie on10 patch gates and earlier) should use pmodes
-from their own workspace.
-
-The information here is suitable for pmodes users in other
-consolidations, using tools from onnv-tools.
-
-
-
-Usage: pmodes [-somwDeNndvqP] [-r file] directory .. proto/pkgmap file....
-
-
-
-Options that modify what is changed:
-
- -s Strip read and write permissions from setgid/setuid executables.
- -o Do not change ownership to root
- -m Do not change file permissions (modes)
- -w Do not strip owner write permissions from non-root owned
- binaries
- -e Do not change 'e' or 'v' (editable or volatile) files
- (they are only affected when owned by bin)
- -D Limit changes to directories only.
-
-Options that modify the output:
- -n Create a <file>.new file
- -N Overwrite the original pkgmap/proto file with the new file;
- old pkgmap/proto file saved as file.old
- -d Produce "diff-style" output
- -P Ignore pkgmap files in directories.
- -q Do not produce error messages about directories w/ pkginfo*
- files
- -v Preceed the output caused by each processed file by a
- shortened version of the filename.
-
- -r file Restrict the test to the pathnames listed in "file"
-
-
-In default mode of operation, pmodes processes each argument.
-If an argument is a directory, it will first look for a pkginfo or
-pkginfo.tmpl file n order to learn the BASEDIR; it will than process
-the directory converting either the pkgmap file or, if the pkgmap file
-doesn't exist or the -P option is specified, the prototype_* files
-Names that contain .old or .new will be ignored. If an argument is a file,
-the pkginfo* file in the same directory is used to learn the BASEDIR.
-
-Pmodes outputs a line for each change made:
-
-e m 0664 -> 0644 /var/adm/wtmpx
-d m 0775 -> 0755 /usr/lib
-d o bin -> root /usr/include/sys [755]
-f o bin -> root /usr/include/sys/cg6reg.h [0644]
-f o bin -> root /usr/include/sys/cg6var.h [0644]
-
-The first field is the "pkgmap" file type; the second field is the type
-of modification (m for mode, o for ownership). This is followed by the
-change mode and the pathname.
-
-When ownership is changed, the file permissions are printed in square
-brackets.
-
-Multiple lines of output can be produced for a single file.
-
-With the -d option, output looks like:
-
-< d 0775 root sys /usr
-> d 0755 root sys /usr
-< d 0775 root bin /usr/include
-> d 0755 root bin /usr/include
-< d 1777 bin bin /var/preserve
-> d 1777 root bin /var/preserve
-< e 0664 root sys /etc/vfstab
-> e 0644 root sys /etc/vfstab
-
-And only one line per file is produced.
-
-
-
-Exceptions
-
-If pmodes insists on flagging errors that you believe must be
-integrated as-is, you may update the inline initializers for either
-exceptions or exempt_pkgs in pmodes.c. If you do this, make sure that
-the bug report and your RTI include a justification for the exception.