.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "VLDB_CHECK 8" .TH VLDB_CHECK 8 "2021-01-14" "OpenAFS" "AFS Command Reference" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" vldb_check \- Checks the integrity of the VLDB .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBvldb_check\fR \fB\-database\fR\ <\fIvldb\ file\fR> [\fB\-uheader\fR] [\fB\-vheader\fR] [\fB\-servers\fR] [\fB\-entries\fR] [\fB\-quiet\fR | \fB\-verbose\fR] [\fB\-fix\fR] [\fB\-help\fR] .PP \&\fBvldb_check\fR \fB\-d\fR\ <\fIvldb\ file\fR> [\fB\-u\fR] [\fB\-vh\fR] [\fB\-s\fR] [\fB\-e\fR] [\fB\-ve\fR] [\fB\-f\fR] [\fB\-h\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \fBvldb_check\fR command checks the integrity of the Volume Location Database (\s-1VLDB\s0), reporting any errors or corruption it finds. If there are problems, do not issue any \fBvos\fR commands until the database is repaired. .SH "CAUTIONS" .IX Header "CAUTIONS" The results can be unpredictable if the Volume Location (\s-1VL\s0) Server makes changes to the \s-1VLDB\s0 while this command is running. Use the \fBbos shutdown\fR command to shutdown the local \fBvlserver\fR process before running this command, or before creating a second copy of the \fIvldb.DB0\fR file (with a different name) on which to run the command. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-database\fR <\fIvldb file\fR>" 4 .IX Item "-database " Names the \s-1VLDB\s0 (copy of the \fIvldb.DB0\fR file) to check. If the current working directory is not the location of the file, provide a pathname, either full or relative to the current working directory. .IP "\fB\-uheader\fR" 4 .IX Item "-uheader" Displays information which Ubik maintains in the database's header. .IP "\fB\-vheader\fR" 4 .IX Item "-vheader" Displays information which the \s-1VL\s0 Server maintains in the database's header. .IP "\fB\-servers\fR <\fIauthentication servers\fR>+" 4 .IX Item "-servers +" Outputs the server entries from the \s-1VLDB,\s0 which list the \s-1IP\s0 addresses registered for each file server machine in the cell. .IP "\fB\-entries\fR" 4 .IX Item "-entries" Outputs every volume entry in the database. The information includes the volume's name and the volume \s-1ID\s0 number for each of its versions. .IP "\fB\-quiet\fR" 4 .IX Item "-quiet" Blocks output from going to stdout. Output to stderr is not blocked. Cannot be used with \-verbose, \-uheader, \-servers or \-entries. .IP "\fB\-verbose\fR" 4 .IX Item "-verbose" Reports additional information about the database, including the number of entries for each type of volume. Cannot be used with \-quiet. .IP "\fB\-fix\fR" 4 .IX Item "-fix" Try to fix errors in the database. If this option is given, \fBvldb_check\fR will open the given database file read-write, and will update the database file in-place. It is recommended that you backup the database file before running with this option, in case \fBvldb_check\fR removes data in order to fix the database. .IP "\fB\-help\fR" 4 .IX Item "-help" Prints the online help for this command. All other valid options are ignored. .SH "OUTPUT" .IX Header "OUTPUT" If there are errors in the database, the output always reports them on the standard error stream. If any options other than \fB\-database\fR or \fB\-help\fR are provided, the output written to the standard output stream includes additional information as described for each option in \*(L"\s-1OPTIONS\*(R"\s0. The output is intended for debugging purposes and is meaningful to someone familiar with the internal structure of the \s-1VLDB.\s0 .PP The \fB\-quiet\fR option can be used to suppress the standard output stream so that the command can be used more easily inside scripts. .PP The command exits with one of the following completion codes: .PP 0: No errors or warnings have been encountered. 1: One or more warnings encountered. 2: One or more warnings and/or errors encountered. 4: A fatal or internal error has occurred and the program cannot proceed. .SH "PRIVILEGE REQUIRED" .IX Header "PRIVILEGE REQUIRED" The issuer must be logged in as the local superuser \f(CW\*(C`root\*(C'\fR. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBvldb.DB0\fR\|(5), \&\fBbos_shutdown\fR\|(8), \&\fBvlserver\fR\|(8) .SH "COPYRIGHT" .IX Header "COPYRIGHT" \&\s-1IBM\s0 Corporation 2000. All Rights Reserved. .PP This documentation is covered by the \s-1IBM\s0 Public License Version 1.0. It was converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.