mk(8)
_________________________________________________________________
mk System Maintenance Procedure
how to remake the DG/UX System and commands
_________________________________________________________________
DESCRIPTION
All sources for the DG/UX system are in a source tree distributed
in the directory /usr/src. This directory includes source for
the operating system, libraries, commands, miscellaneous files
necessary to the running system, and procedures to create
everything from these sources.
The top level consists of the directories cmd, lib, uts, head,
and stand and commands to remake each of these directories.
These commands are named :mk, which remakes everything, and
:mkdir, where dir is the directory to be recreated. Each
recreation command makes all or part of the piece that it
controls. The command :mk runs each of these commands and thus
recreates the whole system.
The lib directory contains libraries used when loading user
programs. The largest and most important of these libraries is
the C library. All libraries are in subdirectories and are
created by a makefile. :mklib rebuilds the libraries given as
arguments. The argument \* causes it to remake all libraries.
The head directory contains the header files, usually found in
/usr/include on the running system. :mkhead installs the header
files given as arguments; the argument \* represents all header
files.
The uts directory contains the source for the DG/UX operating
system kernel. :mkuts (no arguments) invokes a series of
makefiles that builds the kernel.
The stand directory contains stand-alone commands and boot
programs. :mkstand rebuilds and installs these programs.
The cmd directory contains files and directories. :mkcmd
transforms source into a command based upon its makefile (see
make(1)). A directory is assumed to have a makefile that will
create everything associated with that directory and its
subdirectories. Makefiles are named command.mk.
The command :mkcmd recreates commands based on a makefile. All
commands requiring more than one source file are grouped in
subdirectories and must have a makefile.
To rebuild the entire sccs subsystem, use:
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
mk(8)
/usr/src/:mkcmd sccs
To rebuild the delta component of sccs, use:
ARGS="delta" /usr/src/:mkcmd sccs
The argument \* rebuilds all commands and subsystems.
Makefiles, both in ./cmd and in subdirectories, have a standard
format. In particular, :mkcmd depends on existing entries for
install and clobber. Install makes everything under the
makefile's jurisdiction and installs it. Clobber completely
cleans up all unnecessary files resulting from the previous
invocation.
Creating a command from source code is a separate operation from
installing the command on a running system.
SEE ALSO
make(1).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)