From c1a5670e4f4be49d9758e35cdc903418db9a363e Mon Sep 17 00:00:00 2001 From: Gregor Beck Date: Thu, 7 Apr 2011 11:00:41 +0200 Subject: s3-net: document "idmap check" Signed-off-by: Michael Adam Autobuild-User: Michael Adam Autobuild-Date: Thu Apr 7 13:58:13 CEST 2011 on sn-devel-104 --- docs-xml/manpages-3/net.8.xml | 92 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) (limited to 'docs-xml/manpages-3/net.8.xml') diff --git a/docs-xml/manpages-3/net.8.xml b/docs-xml/manpages-3/net.8.xml index 8e5ece0c66..d69a3b7220 100644 --- a/docs-xml/manpages-3/net.8.xml +++ b/docs-xml/manpages-3/net.8.xml @@ -1293,6 +1293,98 @@ Use -f to delete an invalid partial mapping <ID> -> xx + + +IDMAP CHECK [-v] [-r] [-a] [-T] [-f] [-l] [--db=<DB>] + + + Check and repair the IDMAP database. If no option is given a read only check + of the database is done. Among others an interactive or automatic repair mode + may be chosen with one of the following options: + + + -r|--repair + + Interactive repair mode, ask a lot of questions. + + + + -a|--auto + + Noninteractive repair mode, use default answers. + + + + -v|--verbose + + Produce more output. + + + + -f|--force + + Try to apply changes, even if they do not apply cleanly. + + + + -T|--test + + Dry run, show what changes would be made but don't touch anything. + + + + -l|--lock + + Lock the database while doing the check. + + + + --db <DB> + + Check the specified database. + + + + + + + + + It reports about the finding of the following errors: + + + Missing reverse mapping: + + A record with mapping A->B where there is no B->A. Default action + in repair mode is to "fix" this by adding the reverse mapping. + + + + Invalid mapping: + + A record with mapping A->B where B->C. Default action + is to "delete" this record. + + + + Missing or invalid HWM: + + A high water mark is not at least equal to the largest ID in the + database. Default action is to "fix" this by setting it to the + largest ID found +1. + + + + Invalid record: + + Something we failed to parse. Default action is to "edit" it + in interactive and "delete" it in automatic mode. + + + + + + USERSHARE -- cgit