Amiga Unix — 68040 · 68060

Manual pages › General commands (1)

fixperm(1)

corrects or initializes file permissions and ownership.

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

fixperm - corrects or initializes file permissions and ownership.

SYNOPSIS

fixperm [-cDjilnSsvw[-d package] [-u package]] specfile

DESCRIPTION

For each line in the specification file specfile, fixperm makes the listed pathname conform to a specification. fixperm is typically used to configure a XENIX system upon installation. Nonsuper-users can only use fixperm with the -D, -f, -l, or -n options. Only super-users can use the -c,-d,-i,-n,-S, -u,-v, and -w options. The following options are available:

Option Description

-c Creates empty files and missing directories.

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

-d package 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 process all lines.

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

-i Checks only if the selected packages are installed. Return values are:

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

-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.

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

-v             Issues a complaint if executable files are:

                    1) word-swapped
                    2) not fixed-stack
                    3) not separate I and D
                    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 pack-
age  is  a set of files.  A permission specification follows
the package specifier.  The  permission  specification  con-
sists  of  a  file  type,  followed  by a numeric permission
specification.  The item specification is one of the follow-
ing characters:
Character Description
x         executable
a         archive
e         empty file (create if -c option given)
b         block device
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 permis-
          sion conforms to the scheme  described  in  chmod.
          The  owner  and group permissions are in the third
          column separated by slash,  such  as  ``bin/bin''.
          The  fourth  column indicates the number of links.
          If there are links to the file, the next line con-
          tains  the  linked filename with no other informa-
          tion.  The fifth column is a pathname.  The  path-
          name  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 to archive only the
          files in base.perms on /dev/sample:

/etc/fixperm -f/etc/base.perms>list
     tar cfF/dev/sample list
     This command line reports BASE package errors:

/etc/fixperm-nd BASE

NOTES

fixperm is usually only run by a shell script at installation.