Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

custom(1M)



          FIXPERM(1M)          INTERACTIVE UNIX System          FIXPERM(1M)



          NAME
               fixperm - correct or initialize XENIX file permissions and
               ownership

          SYNOPSIS
               fixperm [-acDfgilnSsvw[-dpackage] [-u package]] specfile

          DESCRIPTION
               For each line in the specification file specfile, fixperm
               makes the listed pathname conform to a specification.  fix-
               perm is typically used by the super-user to configure a
               XENIX system upon installation. It has been provided for use
               with any existing XENIX packages that you may have that you
               wish to install on the UNIX system.  Nonsuper-users can only
               use fixperm with the -D, -f, -l, or -n options.

               The following options are available:

               Option  Description

               -a      All files in the perm file must exist. This means
                       that files marked as optional (type letter is in
                       capital letters) must be present.

               -c      Creates empty files and missing directories.

               -D      Lists directories only on standard output.  Does not
                       modify target files.

               -dpackage
                       Processes input lines beginning with given package
                       specifier string (see above).  For instance, -dBASE
                       processes only items specified as belonging to the
                       Basic utilities set.  The default action is to pro-
                       cess all lines.

               -f      Lists files only on standard output. Does not modify
                       target files.

               -g      Lists all devices on the standard output. Target
                       files are not modified (analogous to -l, -f, and
                       -D).

               -i      Checks to see if the selected packages are
                       installed.  Return values are

                            0:   package completely installed
                            4:   package not installed
                            5:   package partially installed

                       If the equivalent package was installed as a UNIX
                       package, -i will not detect it.



          Rev. Base System                                           Page 1





          FIXPERM(1M)          INTERACTIVE UNIX System          FIXPERM(1M)



               -l      Lists files and directories on standard output.
                       Does not modify target files.

               -n      Reports errors only.  Does not modify target files.

               -S      Issues a complaint if files are not in x.out format.

               -s      Modifies special device files in addition to the
                       rest of the permlist.

               -upackage
                       Causes similar action to -d option but processes
                       items that are not part of the given package.

               -v (verbose)
                       Issues a complaint if executable files are 1) word-
                       swapped, 2) not fixed-stack, 3) not separate I and
                       D, or 4) not stripped.

               -w      Lists location (volume number) of the specified
                       files or directories.

             Specification File Format
               Each nonblank line in the specification file consists of
               either a comment or an item specification.  A comment is any
               text from a pound sign ``#'' up to the end of the line.
               There is one item specification per line.  User and group id
               numbers must be specified at the top of the specification
               file for each user and group mentioned in the file.

               An item specification consists of a package specifier, a
               permission specification, owner and group specifications,
               the number of links on the file, the filename, and an
               optional volume number.

               The package specifier is an arbitrary string that is the
               name of a package within a distribution set.  A package is a
               set of files.

               A permission specification follows the package specifier.
               The permission specification consists of a file type, fol-
               lowed by a numeric permission specification.  The item
               specification is one of the following characters:

               Character      Description

               x              executable

               a              archive

               e              empty file (create if -c option given)

               b              block device


          Rev. Base System                                           Page 2





          FIXPERM(1M)          INTERACTIVE UNIX System          FIXPERM(1M)



               c              character device

               d              directory

               f              text file

               p              named pipe

               If the item specification is given as an uppercase letter,
               the file associated with it is optional, and fixperm will
               not return an error message if it does not exist.

               The numeric permission conforms to the scheme described in
               chmod(1).  The owner and group permissions are in the third
               column separated by a slash, such as ``bin/bin''.  The
               fourth column indicates the number of links.  If there are
               links to the file, the next line contains the linked
               filename with no other information.  The fifth column is a
               pathname.  The pathname must be relative (not preceded by a
               slash ``/'').  The sixth column is only used for special
               files, major and minor device numbers, or volume numbers.

          EXAMPLES
               The following two lines make a distribution and invoke
               tar(1) to archive only the files in my_package on
               /dev/sample:

               /etc/fixperm -f /etc/perm/my_package> list
               tar cfF /dev/sample list

               This command line reports package errors:

               /etc/fixperm -nd my_package

          NOTES
               fixperm is usually only run by a shell script at installa-
               tion.

               fixperm should only be run from the directory to which the
               target files are relative.

          SEE ALSO
               custom(1M).












          Rev. Base System                                           Page 3



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026