unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



db_recover(8)							db_recover(8)



NAME

  db_recover - Restores	the database to	a consistent state (Enhanced Secu-
  rity)

SYNOPSIS

  /usr/tcb/bin/db_recover [-cv]	[-h home]

FLAGS

  -c  Failure was catastrophic.

  -h home
      Specify a	home directory for the database.  The correct directory	for
      enhanced security	is /var/tcb/files.

  -l  Write out	the pathnames of all of	the database log files,	whether	or
      not they are involved in active transactions.

  -v  Run in verbose mode.

DESCRIPTION

  A customized version of the Berkeley Database	(Berkeley DB) is embedded in
  the operating	system to provide high-performance database support for	crit-
  ical security	files.	The DB includes	full transactional support and data-
  base recovery, using write-ahead logging and checkpointing to	record
  changes.

  The db_recover utility runs after an unexpected system failure to restore
  the security database	to a consistent	state.	All committed transactions
  are guaranteed to appear after db_recover has	run, and all uncommitted
  transactions are completely undone. DB recovery is normally performed
  automatically	for the	security files as part of system startup.

  In the case of catastrophic failure, an archival copy, or snapshot of	all
  database files must be restored along	with all of the	log files written
  since	the database file snapshot was made.  (If disk space is	a problem,
  log files may	be referenced by symbolic links).

  If the failure was not catastrophic, the files present on the	system at the
  time of failure are sufficient to perform recovery.

  If log files are missing, db_recover identifies the missing log files	and
  fails, in which case the missing log files need to be	restored and recovery
  performed again.

  The db_recover utility attaches to one or more of the	Berkeley DB shared
  memory regions.  In order to avoid region corruption,	it should always be
  given	the chance to detach and exit gracefully.  To cause db_recover to
  clean	up after itself	and exit, send it an interrupt signal (SIGINT).

RETURN VALUES

  The db_recover utility exits 0 on success, and >0 if an error	occurs.



ENVIRONMENT VARIABLES

  DB_HOME If the -h option is not specified and	the environment	variable
	  DB_HOME is set, it is	used as	the path of the	database home.	The
	  home directory for security is /var/tcb/files.

FILES

  /var/tcb/files/auth.db

  /var/tcb/files/dblogs/*

RELATED	INFORMATION

  Commands: db_archive(8), db_checkpoint(8), db_printlog(8), db_dump(8),
  db_load(8), db_stat(8), secconfig(8)