REGEN(1M) — Series 800 Only

NAME

regen − regenerate (uxgen) an updated HP-UX system

SYNOPSIS

regen [-I] [-i] [-L] [-N] [-F] [-O] [-M] [-S] [-B] [-X] [-K] [-G] [-c] [-p] [-A]

DESCRIPTION

Regen is a utility used during the update(1M) process to aid the user in generating a new Series 800 HP-UX kernel.

Only the super-user can execute regen.

By default regen is interactive. If interactive, the user is asked if the configuration file /etc/conf/gen/S800 matches the system’s I/O configuration and options. If it does not, regen proceeds to create a configuration file which does match the system.

Unless the −p option is used, regen changes the configuration file according to the options specified on the command line and in the file /etc/conf/gen/.regenrc. When the customize scripts are run during an update, each product that affects the kernel drops a flag into the .regenrc file. This flag tells regen to include that product’s functionality in the configuration file. If a product’s flag is not included in .regenrc or on the command line, its functionality will be commented out of the configuration file if it is there. In that case regen assumes the product’s libraries have not been updated and whatever is in /etc/conf/lib may be incompatable with the core libraries. If the running kernel is not /hp-ux, /hp-ux does not exist, or if /hp-ux is unreadable, regen may have to ask the user for information about the system. For example, regen may ask what type of root disk or console your system has.

After regen has modified the configuration file, it calls uxgen(1M) to build a kernel using /etc/conf/gen/S800 as input. If the uxgen succeeds, regen saves the old kernel in /SYSBCKUP, moves the new one from /etc/conf/S800/hp-ux to /hp-ux, and copies the new devices file to /etc/devices. If the −i option is used, regen finally does an insf(1M) and copies an /etc/newconfig/inittab into /etc/inittab.

Options

−c If the user claims the file /etc/conf/gen/S800 matches the I/O configuration of his system, check that the console, root, swap, dumps, and args devices match the running kernel’s. If they do not, regen exits with a status 1.

−i Install mode. An S800 file is always created.

−p Plain mode. If the user claims the file /etc/conf/gen/S800 matches the system I/O configuration, the file is used exactly as is. Regen will not modify it according to the options specified on the command line or in the .regenrc file.

−I Non-interactive mode. The file /etc/conf/gen/S800 is modified according to the options specified at the command line and in the .regenrc file. No questions are asked.

−F The NFS product has been loaded. Include the NFS subsystem.

−L The Lan Link product has been loaded. Include the Lan Link subsystem.

−N The NS/9000 Services product has been loaded. Include the NS/9000 Services subsystem.

−M The Mirror Disk product has been loaded. Include the Mirrored Disk subsystem.

−S The Fairshare Scheduler product has been loaded. Include the Fairshare Scheduler subsystem.

−O The OSI Link product has been loaded. Include the OSI Link subsystem.

−B The BX25 product has been loaded. Include the BX25 subsystem.

−X The XT product has been loaded. Include the XT subsystem.

−K The Datakit product has been loaded. Include the Datakit subsystem.

−G The G2 product has been loaded. Include the G2 subsystem.

−A Absolutely no interaction is allowed. Regen exits with a status 1 if it cannot create a kernel without asking the user questions.

DIAGNOSTICS

Exit status is 0 if regen executes successfully and the new kernel is in place. Exit status is 2 if the user quits regen prematurely. If any part of regen fails, exit status is 1.

AUTHOR

Regen was developed by HP.

FILES

/etc/devices
/etc/conf/gen/.regenrc
/etc/master
/etc/newconfig/inittab.ite
/etc/newconfig/inittab.mux
/etc/inittab

Museum

Related Articles