NAME

uconfig − system reconfiguration

SYNOPSIS

/etc/uconfig [ option  boot_device ]

HP-UX COMPATIBILITY

Level: HP-UX/NON-STANDARD

Origin: HP

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 − 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 (maximum memory) divided by (minimum number of cache buffers), 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. 

interactive_time time
where time is an integer in the range 1 to 32 767 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. 

swap_time time
where time is an integer in the range of 1 to 32 767 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 8 192, 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 32 767 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 16 384 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. 

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

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. 

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. 

−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
1 024 bytes;

cache_buf_num
0; this value is dynamically computed;

read_ahead_level
0; this value is dynamically computed;

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

swap_time
0; this value is dynamically computed;

page_size
1 024 bytes;

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

vm_pool_size
0; this value is dynamically computed;

scroll_pages
2;

stack_size
0; this value is dynamically computed;

work_set_ratio
0.002;

max_proc_per_usr
500.

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  —  last mod. May 11, 2021