UNIX System V (XENIX or UNIX) DOCUT(SCO)
Name
docut - creates an application distribution
Syntax
docut [-c] [-e] [-p <Packages root>]
Options
-c create a compressed ./cdist hierarchy.
-e erase previously created data files and start from scratch.
-p cut a distribution that is in packages.
Description
The docut(SCO) utility provides an interactive method of
cutting an application distribution. When docut completes, a
mkmaster script is created and executed on the directory
containing your distribution. Use docut as follows:
1. Copy all distribution files with the tar(C) utility
into a new directory, for example, one named ./source.
(The "./misc", "./dist" and "./cdist" directories are
reserved names that cannot be used.).
2. Execute docut without parameters. First 'mkperm -O
dist' is invoked. You are prompted for the name of the
directory containing your distribution. If the defaults
are used, a permissions file is created in
./dist/tmp/perms and an image of your distribution
hierarchy is created using links to the ./dist
directory.
3. In the course of running docut, the following values
are requested to create the mkmaster script:
BLOCKING: Blocking factor if required.
DEVICE: Device name for archiving distribution.
FORMAT: Complete command needed to format a volume.
VOLSIZE: Size of each distribution volume.
If the -p option to docut is specified, then distribution
files are assumed to be organized in packages under the
specified directory. For example, if -p is specified, then
the pathnames of the files are in the form:
./directory/package-name/file-path
For example:
./source/GIZ/usr/bin/gizmo
source is the directory, GIZ is a package, and
/usr/bin/gizmo is a file that when the cut takes place will
be placed in the /usr/bin directory.
docut calls mkperm(SCO) with each package directory and name
so you are only prompted for package descriptions. For
example, if a distribution has three packages named PKG1,
PKG2 and PKG3 then the directory hierarchy would be set up
as follows:
dirname
PKG1 PKG2 PKG3
pkg1 files pkg2 files pkg3 files
After setting up the distribution directory hierarchy,
invoke ``docut -p dirname''. An image of all packages
layered onto each other is created in the ./dist directory.
The -c flag is passed to mkmaster, which then creates a
compressed hierarchy ./cdist from which the distribution is
cut. Note that the ./dist directory is still created and
used in this process.
The -e flag instructs docut to erase the ./misc/mkm.tun file
containing tunable variables inserted by mkmaster, and the
./misc/pf.data file created by mkperm to store product data.
Both of these files can be recreated by running docut
without options. When docut -e is run, the following
message is displayed:
This flag erases previous mkperm and mkmaster data files.
Are you sure you wish to do this (y/n)
Enter ``y'' for yes, or ``n'' for no.
Note
Because data files are retained, only invoke docut with
desired parameters the first time it is used.
Error Messages
device does not exist.
The specified device for archiving the distribution does not
exist or you do not have write access to the device.
Specify the full pathname or ensure that permission modes
are set correctly. Device pathnames can be viewed by
displaying the contents of the /etc/default/tar file.
Error: name is not a directory
The specified package directory cannot be found.
Mkmaster core file /usr/lib/mkm.core is missing.
Cannot create mkmaster script without this file.
The /usr/lib/mkm.core file cannot be found. This file is
contained in the Toolkit software. Re-install the Toolkit
software.
Perms data file missing. Please run mkperm to create this
file.
While attempting to create the mkmaster script, the file
could not be found. Run docut without options to create
this file.
Please answer y or n
A value other than ``y'' or ``n'' was entered at a prompt.
This message is displayed if <Enter> is pressed without a
value.
Files
/etc/fixperm
/usr/bin/mkperm
./misc/pf.data
./misc/mkm.tun
See Also
mkcuts(SCO), mkmaster(SCO), mkperm(SCO), tar(C)
(printed 5/17/90) (XENIX or UNIX) DOCUT(SCO)