CONFIG(C) XENIX System V CONFIG(C)
Name
config - Configures a XENIX system.
Syntax
/usr/sys/conf/config [ -i ] [ -c file] -m master dfile
Description
config takes a description of a XENIX system and generates
compilable files that define the configuration tables for
the various devices on the system.
Options include:
-m Specifies the name of the file that contains all the
information regarding supported devices;
/usr/sys/conf/master is the standard name. This file
is supplied with the XENIX system and should not be
modified by the user. The configure(C) utility should
be used to update /usr/sys/conf/master and dfile.
-i Requests assembly-language output, instead of the
default C language output.
-c Specifies the names of the configuration table files.
c.c and space.c are the default names unless the -i
option is given, in which case the default names are
c.asm and space.inc.
dfile contains system device information and is divided into
two parts. The first contains physical device
specifications. The second contains system-dependent
information. Any line with an asterisk (*) in column 1 is a
comment. A standard dfile is provided as
/usr/sys/conf/xenixconf. The configure(C) utility should
also be used to update.
All configurations are assumed to have a set of required
devices, such as the system clock, which must be present to
run XENIX. These devices must not be specified in dfile.
First Part of dfile
Each line contains two fields, delimited by spaces and/or
tabs in the following format:
devname number
where devname is the name of the device, and number is the
number (decimal) of devices associated with the
corresponding controller. The device name can be any name
given in part 1 of the /usr/sys/conf/master file, or any
alias given in part 3 of the same file; number is optional,
Page 1 (printed 8/7/87)
CONFIG(C) XENIX System V CONFIG(C)
and if omitted, a default value which is the maximum value
for that controller is used.
There are certain drivers that may be provided with the
system that are actually pseudo-device drivers; that is,
there is no real hardware associated with the driver. If
the system has such drivers, they are described in section M
of the XENIX User's Reference Manual.
Second Part of dfile
The second part contains three different types of lines.
Note that all specifications of this part are required,
although their order is arbitrary.
1. root/pipe device specification
Two lines, each having three fields:
root devname minor
pipe devname minor
where devname is the name of the device, and minor is the
minor device number (in octal). The device name can be any
name given in part 1 of the /usr/sys/conf/master file, or
any alias given in part 3 of the same file.
2. swap device specification
One line that contains five fields as follows:
swap devname minor swplo nswap
where devname is the name of the device, minor is the minor
device number (in octal), swplo is the lowest disk block
(decimal) in the swap area, and nswap is the number of disk
blocks (decimal) in the swap area. The device name can be
any name given in part 1 of the /usr/sys/conf/master file,
or any alias given in part 3 of the same file.
3. Parameter specification
One or more lines, each having two fields as follows:
name number
where name is a tunable parameter name, and number is the
desired value (in decimal) for the given parameter. Only
names that have been defined in part 4 of the
/usr/sys/conf/master file
Page 2 (printed 8/7/87)
CONFIG(C) XENIX System V CONFIG(C)
can be used; number overrides the default value for the
given parameter. The following is a list of the available
parameters:
buffers Maximum number of external (mapped-out)
buffers available to the kernel. If set
to 0, config computes the optimum number
for the system.
sabufs Maximum number of internal (non-mapped)
buffers available.
hashbuf Maximum number of hash buffers.
inodes Maximum number of inodes per file
system.
files Maximum number of open files per file
system.
mounts Maximum number of mounted file systems.
coremap Maximum number of core map elements.
swapmap Maximum number of swap map elements.
pages Number of memory pages. On segmented
systems such as the 286, this value
should be 0.
calls Maximum number of entries in the system
timeout table.
procs Maximum number of processes per system.
maxproc Maximum number of processes per user.
texts Maximum number of text segments per
system.
clists Maximum number of clists per system.
locks Maximum number of file locks per system.
shdata Maximum number of shared data segments
per system.
timezone Number of minutes difference between the
local timezone and Greenwich Mean Time.
daylight Daylight savings time in effect (1) or
not in effect (0).
msgmap Number of entries in message map.
msgmax Maximum message size.
msgmnb Maximum number of bytes in a message
queue.
msgmni Number of message queue identifiers.
msgtql Number of message headers in the system.
msgssz Number of bytes in message segments.
msgseg Number of message segments.
semmap Number of entries in semaphore map.
semmni Number of semaphore identifiers.
semmnu Number of undo structures in the system.
semmsl Maximum number of semaphores per
identifier.
semopm Maximum number of operations per
semop(S) call.
semume Maximum number of undo entries per
process.
Page 3 (printed 8/7/87)
CONFIG(C) XENIX System V CONFIG(C)
semvmx Maximum semaphore value.
semaem Maximum value for ``adjust on exit''.
semmns Number of semaphores in the system.
cmask Default file creation mask for process
0.
maxprocmem Maximum amount of memory available per
process. This value cannot be greater
than 75% of total user memory. If set
to 0, config computes the optimum value.
screens Number of Multiscreens for the systems.
If set to 0, config computes the optimum
value.
emaps Maximum number of distinct eight-bit
channel maps in the system.
nodename The nodename of the system (as used by
uucp(C) and other programs).
Examples
Suppose you wish to configure a system with the following
devices:
One HD disk drive controller with 1 drive
One FD floppy disk drive controller with 1 drive
You must also specify the following parameter information:
root device is an HD (pseudo disk 3)
pipe device is an HD (pseudo disk 3)
swap device is an HD (pseudo disk 2)
with a swplo of 0 and a nswap of 2300
number of buffers is 50
number of processes is 50
maximum number of processes per user ID is 15
number of mounts is 8
number of inodes is 120
number of files is 120
number of calls is 30
number of texts is 35
number of character buffers is 150
number of swapmap entries is 50
number of memory pages is 512
number of file locks is 100
timezone is pacific time
daylight time is in effect
number of entries in message map is 513
maximum message size is 8192
maximum number of bytes in a message queue is 16384
number of message queue identifiers is 10
number of message headers in the system is 40
message segment size is 8
number of message segments is 1024
number of entries in semaphore map is 21
Page 4 (printed 8/7/87)
CONFIG(C) XENIX System V CONFIG(C)
number of semaphore identifiers is 10
number of undo structures in the system is 60
maximum number of semaphores per identifiers is 10
maximum number of operations per semop call is 5
maximum number of undo entries per process is 5
maximum semaphore value is 32767
maximum value for ``adjust on exit'' is 16384
number of semaphores in the system is 40
The actual system configuration would be specified as
follows:
hd 1
fd 1
root hd 3
pipe hd 3
swap hd 2 0 2300
* Comments may be inserted in this manner
buffers 50
procs 150
maxproc 15
mounts 8
inodes 120
files 120
calls 30
texts 35
clists 150
swapmap 50
pages (1024/2);
locks 100
timezone (8*60)
daylight 1
msgmap (MSGSEG/2+1)
msgmax 8192
msgmnb 8192
msgmni 10
msgtql 40
msgssz 8
msgseg 1024
semmap (SEMMNS/2+1)
semmni 10
semmnu 20
semmsl 10
semopm 5
semume 5
semvmx 32767
semaem 16384
semmns 40
Page 5 (printed 8/7/87)
CONFIG(C) XENIX System V CONFIG(C)
Files
/usr/sys/conf/master default input master device table
c.c default output driver configuration table file
space.c default output resource configuration table file
c.asm default driver configuration in assembly language
space.inc default resource configuration in assembly language
See Also
configure(C), master(F)
Diagnostics
Diagnostics are routed to the standard output and are self-
explanatory.
Notes
The value on the right-hand side of a a parameter
specification must be a double-quoted character string, an
integer, the name of another parameter defined within the
master(F) file, or some arithmetical combination of integers
and defined parameter names. Only the ``+'', ``-'', ``*'',
and ``/'' operators can be used in an arithmetical
expression. Expressions are interpreted left-to-right: if
operator precedence is in doubt, parenthesize.
Page 6 (printed 8/7/87)