Series 500 Only

NAME

uconfig − system reconfiguration

SYNOPSIS

/etc/uconfig [ option  boot_device ]

Remarks:

Uconfig is implemented on the Series 500 only. 

DESCRIPTION

Uconfig enables you to reconfigure certain system parameters.  When invoked with no arguments, uconfig lists the current system configuration.  The following options are recognized:

−f  file reconfigures the system parameters in the boot area according to the specifications given in file. File may contain any combination of system parameters.  Each line in file has the following format:

id value [#comment]

where id is a pre-defined system parameter name, value is one or more values associated with the parameter, and comment is a descriptive comment for that line.  All characters between the comment delimiter ( # ) and a new-line are ignored.  The id, value, and comment fields are delimited by one or more blanks and/or tabs. 

The valid ids and values are:

vm_device driver_name addr1 addr2 addr3 addr4
where driver_name is an integer specifying the virtual device driver, and addr1 through addr4 are integers specifying the device select code, HP-IB address, unit, and volume, respectively. 

cache_buf_size size
where size is an integer in the range 256 to 524288, specifying the number of bytes in each individual cache buffer. Size is rounded down to the closest multiple of 256. 

cache_buf_num num
where num is an integer in the range 1 to (maximum memory) divided by (minimum size of cache buffers), specifying the number of individual cache buffers forming the cache. 

read_ahead_level level
where level is an integer in the range 1 to the value of cache_buf_num, specifying the number of buffers that can be filled in one sequential read operation. 

swap_time time
where time is an integer in the range of 1 to 32767 ticks (a tick equals 10msec), specifying the time a virtual segment remains memory resident before being swapped to disc.

page_size size
where size is an integer in the range 512 to 8192, specifying the size of paged data in bytes.  If size is an odd number, it is rounded down to the next even number. 

page_swap_time time
where time is an integer in the range 1 to 32767 ticks (a tick equals 10 msecs), specifying the time a page remains memory resident before being swapped to disc.

vm_pool_size size
where size is an integer in the range 16384 to maximum memory, specifying the maximum size in bytes of the virtual memory page pool.

scroll_pages num_pages
where num_pages is an integer in the range 1 to 10, specifying the number of pages of display buffering (one page = 24 lines of display).  The actual number of pages allocated depends on current available memory.  This parameter applies to the Model 520 only. 

max_proc_per_usr max_user_process
where max_user_process is an integer specifying the maximum number of processes a single user can have. 

stack_size size
where size is an integer in the range 16384 to maximum memory, specifying the maximum stack size in bytes for any partition.

interactive_time time
where time is an integer in the range 1 to 32767 ticks (a tick equals 10 msecs), specifying the amount of CPU time a process can consume after an interactive terminal read before it is no longer favored as interactive. 

max_num_msgids num_ids
where num_ids is an integer in the range 5 to 1000, specifying the maximum number of message queue identifiers.  Num_ids is rounded down to the closest multiple of 5. 

max_msg_size size
where size is an integer in the range 256 to either 65536 or max_msg_qbytes, whichever is less, specifying the maximum size in bytes of any one message. 

max_msg_qbytes size
where size is an integer in the range 256 to either 65536 or max_msg_space, whichever is less, specifying the maximum size in bytes of any one message queue. 

max_msg_space size
where size is an integer in the range 256 to 523264, specifying the maximum size in bytes the sum of all messages on all message queues.

max_num_semids num_ids
where num_ids is an integer in the range 5 to 1000, specifying the maximum number of semaphore identifiers.  Num_ids is rounded down to the closest multiple of 5. 

max_num_shmids num_ids
where num_ids is an integer in the range 5 to 1000, specifying the maximum number of shared memory identifiers.  Num_ids is rounded down to the closest multiple of 5. 

max_num_shm_segs segs
where segs is an integer in the range 0 to 1000, specifying the maximum number of shared memory segment attaches per process. 

max_shm_vsegsz size
where size is an integer in the range 0 to 523264, specifying the upper size limit of normal virtual shared memory segments in bytes. Requests for shared memory segment sizes larger than this value will result in paged virtual shared memory segments.

work_set_ratio ratio
where ratio is a floating-point number in the range 0 to 1, specifying the minimum virtual memory working set ratio. 

−d reconfigures the system parameters in the boot area to their default values.  The default values, as contained in the file /etc/uconfigtab, are:

vm_device 0 0 0 0 0; root device as determined by the system at power-up;

cache_buf_size 1024 bytes;

cache_buf_num 0; this value is dynamically computed;

read_ahead_level 0; this value is dynamically computed;

swap_time 0; this value is dynamically computed;

page_size 1024 bytes;

page_swap_time 50 ticks; (one tick = 10 msecs);

vm_pool_size 0; this value is dynamically computed;

scroll_pages 2;

max_proc_per_usr 500;

stack_size 0; this value is dynamically computed;

interactive_time 300 ticks; (one tick = 10 msecs);

max_num_msgids 100;

max_msg_size 8192 bytes;

max_msg_qbytes 16384 bytes;

max_msg_space 32768 bytes;

max_num_semids 100;

max_num_shmids 100;

max_num_shm_segs 10;

max_shm_vsegsz 16384 bytes;

work_set_ratio 0.002. 

The −f and −d options are mutually exclusive. 

Boot_device is the path name of a character special file containing a boot area.  The new configuration is written out to the boot area on boot_device, and takes effect the next time the system is booted.

FILES

/etc/uconfigtab list of default system configuration parameters

WARNING

Do not use uconfig to change the system parameters of an operating system in a boot area unless that operating system is identical to the operating system you are currently running.  If the two operating systems differ, uconfig will execute successfully, but the new operating system will either fail to boot, or, if it boots successfully, exhibit strange behavior. 

Hewlett-Packard Company  —  April 12, 1993