MOUNT[NON-HFSJ (1M) HP-UX Series 500 Only
4 VOLCONT 5 HEADER
6 FIRSTSEG 7 SEGTYPE 8 SEGLEN 9 CHECKSUM 10 TERM SEE ALSO
Series 500 Only
bad volume (not SDF, no boot area, etc.);
invalid or inconsistent OSF header(s);
first segment is not a power-up segment;
incompatible segment system types or revisions;
segment length out of range or not whole words;
segment checksum does not match reference value;
system terminator ("-1" word) missing.
osck(IM), oscp(IM), osmark(IM), sdfinit(IM).
Hewlett-Packard Company 2
-OSMGR(lM)
October 1986
PDC(lM) PDC(lM) Series 800 Only
NAME
pdc - processor dependent code (finnware) DESCRIPTION
Pdc is the finnware that implements all processor dependent functionality including initialization and self-test of the processor. Upon completion it loads and transfers control to the initial system loader (isl{1M)).
In order to load isl from an external medium, pdc must know the particular device on which isl resides. Typically the device is identified by the Primary Boot Path that is maintained by pdc. A path specification is a series of decimal numbers separated by periods that gives the various card and slot numbers and addresses. For the Model 840, the first number is the MID-BUS module number (i.e. slot number times four) and the next the CIO slot number. If the CIO slot contains an HP-IB card, the next number is the HP-IB address, followed by the unit number of the device if the device supports units. If the CIO slot contains a tenninal card, the next number is the port number, which must be zero for the console.
When the processor is reset, after initialization and self-test are complete, pdc announces the Pri-mary Boot, Alternate Boot, and Console Paths. If autoboot (see isl{1M)) is enabled then pdc gives a 10 second delay in which the operator may override the autoboot sequence by entering any character on the console. If the autoboot sequence is overriden or not enabled in the first place, pdc interactively prompts the operator for the Boot Path to use. Any required path components that are not supplied default to zero. The Primary Boot, Alternate Boot, and Console Paths and autoboot enable may be modified via isl.
SEE ALSO
boot{1M), hpuxboot{1M), isl(1M).
Hewlett-Packard Company - 1 - December 1986
PWCK(lM) HP-UX PWCK(lM)
NAME
pwck, grpck - password/group file checkers SYNOPSIS
/ete/pwek [file]
/ete/grpck [IDe]
DESCRIPTION
FILES
Pwck scans the password IDe and notes any inconsistencies. The checks include validation of the number of fields, login name, user ID, group ID, and whether the login directory and optional pro-gram name exist. The criteria for determining a valid login name are taken from HP-UX System Administrator's Manual for your system. The default password file is /ete/passwd.
Grpck verifies all entries in the group file. This verification includes a check of the number of fields, group name, group ID, and whether all login names appear in the password file. The default group file is jete/group.
jetcjgroup jetcjpasswd SEE ALSO
group(4), passwd(4).
DIAGNOSTICS
Group entries in / ete / group with no login names are flagged.
Hewlett-Packard Company - 1 - Version B.1, October 1986
REBOOT(lM) HP-UX REBOOT(lM)
Reboot terminates all currently executing processes, except those essential to the system, then halts or reboots the system. Reboot with no arguments syncs all disks before rebooting the sys-tem. The options are:
-h shutdown the system and halt.
-r -n --s -d device
shutdown the system and reboot automatically. (default) do not sync the file systems before shutdown.
sync the file systems before shutdown; for file systems which were cleanly mounted, modify the fs_clean flag from FS_OK to FS_CLEAN. (default)
reboot from the specified device. The device must be a lif volume. This option can-not be used with -h.
-f lif_filename
-t time
reboot from the specified file. If the filename is the NULL string, the power up search sequence will be made for a system. Otherwise, the filename has to follow the Iif filename convention. This option cannot be used with -h.
the time when reboot will bring the system down. Time may be the word now (indicating immediate shutdown) or specify a future time in one of two formats:
+number and hour:min. The first form brings the system down in number minutes and the second brings the system down at the time of day indicated (as a 24-hour clock).
-m message At intervals that get closer together as reboot time approaches, message is displayed at the terminals of all users on the system.
At shutdown time a message is written in the file /usr/adm/shutdownlog(ifitexists), contain-ing the time of shutdown, who ran reboot, and the reason.
Reboot can be executed only by the super-user.
HARDW ARE DEPENDENCIES Series 500
Reboot is not supported. A similar non-standard facility is provided for the Series 500 by stopsys(IM).
Series 800
The -d and -f options and the device and lif_filename parameters are ignored.
AUTHOR
Reboot was developed by HP, and the University of California, Berkeley.
FILES
RECONFIG (1M) RECONFIG (1M) Series 300 Only
NAME
reconfig - configure an HP-UX system SYNOPSIS
jetcjreconfig [-m]
Remarks:
reconfig is implemented on the Series 300 only.
DESCRIPTION
Reconfig provides a means for system upgrade in the following areas:
• Operating system functionality,
• Adding new users to the system,
• Deleting existing users from the system,
• Adding support for remote-terminal access,
• Adding line printer support to the system,
• Setting up system user access.
Reconfig provides a useful, easy-to-use tool for upgrading and customizing HP-UX systems to match particular needs. Thus, upgrading an existing operating system to add new users or peri-pherals becomes a simple task.
Reconfig is a menu-driven command that is easy to use, even with little knowledge. Once a menu is displayed, the following rules apply:
Softkey Label Definition or Use
HELP Displays information describing your currently available options.
MAINMENU
No configuration information associated with the current menu is processed, and any modified values are destroyed.
Moves cursor to next or previous choice on multiple-choice action menu or field.
Exits reconfig.
restores all fields in the current menu to their original (default) values before any values were changed.
Initiates the configuration action associated with the current cursor position (highlighted field).
Many menus also prompt for inputs. Each input is terminated by pressing [RETURN] or by pressing one of the displayed softkeys. To select a displayed default value from the field asso-ciated with a given prompt, press [RETURN] without typing an entry.
Some fields offer multiple choices where all valid choices are displayed simultaneously and the default choice is displayed following the input prompt. Type the preferred choice and press [RETURN] or use the NEXT or PREVIOUS softkey to display the next/previous choice then press SELECT or [RETURN] when the correct option is reached.
When responding to prompts that expect a yes/no answer, use y or n or yes or no in any combination of uppercase or lowercase letters followed by [RETURN].
Some menus (such as adding users) cycle repeatedly so you can perform the operation more than once in succession. To exit such menus, press MAINMENU. Any completed configurations associated with the cycling menu are left intact. If MAINMENU is pressed before a cycle is completed, any partial configurations are abandoned without altering system
Hewlett-Packard Company - 1 - October 1986
RECONFIG (1M) RECONFIG(1M) sequences; that is, terminals that are not officially supported by HP-UX.
This mode of operation is the same as normal operation with the following exceptions:
Menus offering a choice of actions to perform identify each action with an associated number or letter. To choose an option, press the number or letter (uppercase or lowercase), then press [RETURN].
The QUIT, RESTORE, MAINMENU, and HELP softkeys are replaced with the letters q, r, m, and h, respectively. To select one, press the correct letter followed by [RETURN].
When prompted for a choice in a multiple-choice field, type the corresponding number or letter or type in the choice itself, then press [RETURN]. deleted, if that option is specified.
When a new printer is added to the system, all required device nodes will automatically be made, and the line printer spooler will be notified that a new printer is now available for use.
When setting up user access to the system, you can choose whether or not a user login is required.
If login is required, the system must operate in init state 2 (multi-user state) and each user must be known to the system (use the reeonfig option for adding new users). If login is not required, the system must operate in init state 1 (single-user state), and the system automatically starts running PAM (Personal Applications Manager) after power-up.
When remote terminal support is added for a new port, the file /etc/inittab will be updated, so that the next time the system is powered up, a getty will automatically be started for the specified port. Any required device nodes will be created, if necessary. Only one getty is permitted to run on any particular port.
When the user wishes to modify his operating system, he is supplied with three options:
1. Generate a fully loaded operating system.
2. Generate a minimally loaded operating system.
3. Generate a custom kernel.
description file for current operating system current operating system
Hewlett-Packard Company - 2 - October 1986
RECONFIG (1M)
/etc/inittab /etc/p8i3swd /etc/group /users SEE ALSO
config(lm)
Hewlett-Packard Company
Series 300 Only
system initialization tables system p8i3sword file
system groups identification file system users identification file
3
-RECONFIG (1M)
Version B.1, October 1986
REVCK(lM) REVCK(lM) Series 200, 300, and 600 Only
NAME
revck - check internal revision numbers of HP-UX files SYNOPSIS
/etc/revck reLfiles Remarks:
Not supported on the Integral Personal Computer.
DESCRIPTION
FILES
Revck checks the internal revision numbers of lists of files against reference lists. Each reI_file must contain a list of absolute path names (each beginning with"/,,) and whatstrings (revision information strings from what(l)). Path names begin in column one of a line, and have a colon appended to them. Each path name is followed by zero or more lines of whatstrings, one per line, each indented by at least one tab (this is the same format in which what(l) outputs its results).
For each path name, revck checks that the file exists, and that executing what(l) on the current path name produces results identical to the whatstrings in the reference file. Only the first 1024 bytes of whatstrings are checked.
ReI_files are usually the absolute path names of the revlist files shipped with UX. Each HP-UX software product includes a file named /system/product/revlist (for example, /system/97070A/revlist). The revlist file for each product is a reference list for the ordinary files shipped with the product, plus any empty directories on which the product depends.
/system/ product/rev list SEE ALSO
lists of HP-UX files and revision numbers what(I).
DIAGNOSTICS
Revck is silent except for reporting missing files or mismatches. If a reI_file is not in the right format, you will get unpredictable results.
Hewlett-Packard Company - 1 - October 1986
ROOTMARK (1M)
Series 500 Only
rootmark - mark/unmark volume as HP-UX root volume SYNOPSIS
/etc/rootmark [ -m I -u 1 filespec Remarks:
Rootmark is implemented on the Series 500 only.
DESCRIPTION
ROOTMARK (1M)
Rootmark enables you to control which mass storage device contains your HP-UX root
U)
direc-tory. The HP-UX operating system searches mass storage devices and uses the first root volume it finds.Filespec is usually a character special file which points to a mass storage volume initialized with Structured Directory Format (SDF). If invoked with no option, rootmark tells the current state of the specified volume. If -m is specified, then the specified volume is marked as a root volume.
If -u is specified, the specified volume is marked as not a root volume. Rootmark is silent if suc-cessful.
RETURN VALUE
Rootmark sends an error message to standard error and returns a non-zero value if it cannot read or write a volume, or if a volume is not SDF. Rootmark returns 1 for incorrect syntax, 2 for a file system problem, and 3 for a volume that is not in SDF.
EXAMPLE
The following example makes /dev /rhd usable as root; you must super-user to execute the exam-ple:
SEE ALSO
# rootmark /dev/rhd # check if /dev/rhd is a root volume /dev/rhd is marked as NOT a root volume.
#
rootmark -m /dev/rhd#
mart it as the root volume#
rootmark /dev /rhd#
check results /dev/rhd is marked as a root volume.mount{l), osmgr{lM), sdfinit{lM).
WARNINGS
A volume must not be marked as a root volume unless it contains all the directories and files that HP-UX requires for system initialization.
Never mark any media shipped from Hewlett-Packard as not a root volume, in case you need to re-install HP-UX from that media.
Hewlett-Packard Company - 1 - October 1986
RUNACCT(lM) HP-UX RUNACCT(lM)
Runacct processes connect, fee, disk, and process accounting files. It also prepares summary files for prdaily or billing purposes. more than one invocation per day.
Runacct breaks its processing into separate, restartable states using stateftle to remember the last state completed. It accomplishes this by writing the state name into statefile. Runacct then looks in stateftle to see what it has done and to determine what to process next. States are exe-cuted in the following order:
SETUP Move active accounting files into working files.
WTMPFIX Verify integrity of wtmp file, correcting date changes if necessary.
CONNECTl Produce connect session records in ctmp.h format.
CONNECT2 Convert ctmp.h records into tacct.h format.
PROCESS MERGE FEES DISK
Convert process accounting records into tacct.h format.
Merge the connect and process accounting records.
Convert output of chargefee into tacct.h format and merge with connect and process accounting records.
Merge disk accounting records with connect, process, and fee accounting records.
MERGETACCT
Merge the daily total accounting records in daytacct with the summary total accounting records in /usr/adm/acct/sum/tacct.
CMS Produce command summaries.
USEREXIT Any installation-dependent accounting programs can be included here.
CLEANUP Cleanup temporary files and exit.
To restart runacct after a failure, first check the active file for diagnostics, then fix up any cor-rupted data files such as pacct or wtmp. The lock files and lastdate file must be removed before runacct can be restarted. The argument mmdd is necessary if runacct is being restarted, and specifies the month and day for which Tunacct will rerun the accounting. Entry point for processing is based on the contents of stateftle; to override this, include the desired state on the command line to designate where processing should begin.
EXAMPLES
To start Tunacct.
nohup runacct 2> jusrjadmjacctjnitejfd210g &
To restart Tunacct.
nohup runacct 0601 2» jusrjadmjacctjnitejfd210g &
Hewlett-Packard Company - 1 - Version B.1, October 1986
RUNACCT (1M) HP-UX RUNACCT (1M)
FILES
To restart runacct at a specific state.
nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd2Iog &
/usr/adm/acct/nite/active /usr/src/cmd/acct/ctmp.h /usr/adm/acct/nite/daytacct /usr / adm/ acct/nite/lastdate /usr/adm/acct/nite/lock /usr/adm/acct/nite/lockl /usr / adm/pacch
/usr/adm/acct/nite/ptacch.mmdd /usr/adm/acct/nite/statefile /usr /src/ cmd/ acct/tacct.h /etc/wtmp
SEE ALSO
BUGS
acctcom(l), mail(l), acct(1M), acctcms(IM), acctcon(IM), acctmerg(IM), acctprc(IM), acctsh(IM), cron(IM), fwtmp(IM), acct(2), acct(4), utmp(4), System Accounting in the HP-UX System Administrator's Manual.
Normally it is not a good idea to restart runacct in the SETUP state. Run SETUP manually and restart via:
runacct mmdd WTMPFIX
If runacct failed in the PROCESS state, remove the last ptacct file because it will not be com-plete.
Hewlett-Packard Company - 2 - Version B.l, October 1986
SAVECORE(lM) HP-UX Series 800 Only
SAVECORE(lM)
NAME
savecore - save a core dump of the operating system SYNOPSIS
Save core checks the core dump to be certain it corresponds with the current running system. If it does it saves the core image in the file dirname /hp-core.n and a copy of the current running (especially on machines with large physical memories).
Savecore also writes a reboot message in the shutdown log (if it already exists). If the system crashed as a result of a panic, savecore records the panic string in the shutdown log too.
If the core dump was from a system other than /hp-ux, the name of that system must be supplied
Savecore was developed by the Hewlett-Packard Company, and the University of California, Berkeley California, Computer Science Division, Department of Electrical Engineering and Com-puter Science.
SDFDF(lM)
NAME
HP-UX Series 300, 800 Only
sdfdf - report number of free SDF disk blocks SYNOPSIS
sdfdf device ...
DESCRIPTION
SDFDF(lM)
Sdfdf prints out the number of free blocks and free inodes available for SDF file systems by exa-mining the counts kept in the super-blocks; device must be specified by device name.
AUTHOR
Sdfdfwas developed by the Hewlett-Packard Company.
SEE ALSO
sdf(4), du{l), df{lM).
Hewlett-Packard Company - 1 - Version B.1, October 1986
SDFFSCK(lM) HP-UX Series 300, 800 Only
SDFFSCK(lM)
NAME
sdffsck - SDF file system consistency check, interactive repair SYNOPSIS
sdffsck [-y] [-n] [-s] [-d] SDFdevice ...
DESCRIPTION
Sdffsck is intended to mimic the series 500 implementation of Isck[SDFJ(lM}.
Sdffsck checks and interactively repairs inconsistent conditions for SDF
me
systems. If theme
operator to respond yes or no. If the operator does not have write permission, sdffsck defaults to -noSdffsck makes multiple passes over the SDF file system, so care should be taken to ensure that the SDF device is quiescent.
The following flags are interpreted by sdffsck:
-y Assume a yes response to all questions asked.
-n Assume a no response to all questions asked; do not open the
me
system for writing.-s Ignore the actual free list and unconditionally reconstruct a new one. This option is useful in correcting multiply claimed blocks when one of the claimants is the free list. When using this option, the number of unclaimed blocks reported by sdffsck includes all the blocks in the free map. This can produce extensive output if -d is also selected.
-s should only be selected after a previous sdffsck indicates a conflict between a file and the appropriate warning is printed. The diagnostics are intended to be self-explanatory.
SDFdevice is a device
me
name describing the device on which the SDF file system to be checked resides (e.g., /dev/rdsk/cld1s4).Error messages from sdffsck are written to stderr. Information generated because of the -d option and normal output is written to stdout; both are unbuffered.
Inconsistencies checked include:
1. Blocks claimed by more than one inode, or by the free list;
2. Blocks claimed by an inode or the free list outside the range of the file system;
3. Incorrect link counts;
4. Blocks not accounted for anywhere;
5. Bad inode format;
6. Directory checks:
Files pointing to unallocated inodes;
Inode numbers out of range;
Hewlett-Packard Company - 1 - Version B.1, October 1986
SDFFSCK (1M)
Mult.iply linked directories;
Link to the parent directory.
HP-UX