'\" 
.\" @(#)blobadm.1m	1.3 01 Oct 1998 SMI
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\" All Rights Reserved
.\" Copyright (c) AT&T 1998. All rights reserved.
.\" @(#)blobadm.rof	1.3 6/7/98
.TH blobadm 1m "22 Sep 1998"
.if n .tr \--
.SH "NAME"
blobadm - display statistical information; check, compress, and configure a well-known or specified blobfile.
.SH SYNOPSIS
.ft4
.nf
blobadm  [options] -A | -B | -C | -D domainname | -R | -F filename | -L
.SH DESCRIPTION
The blobadm command displays information for a specified blobfile. 
It also can be used to check a blobfile, grow the data portion of 
a blobfile, compress and remove extra free space of a blobfile,
or to update key information. 
.sp .5
To understand the displayed information, the pages at the head of 
the blobfile contain control information, followed by the free block map, 
up to three hash tables, and the key table. 
.sp .5
This is followed by the data portion of a file which consists 
of a configurable number of pages. 
Each page is 4 KBytes and consists of 32 fragments, each 128 bytes.
.sp .5
The well-known blobfiles are the ACL store, 
the BUILTIN accounts store, the change log,
domain SAM database, the LSA store, and the Registry store. 
.SH OPTIONS
.SS -A 
Displays information about the ACL store.
.SS -B
Displays information about the BUILTIN accounts store.
.SS -C
Displays information about the change log.
.SS -D domainname
Displays information for the specified SAM domainname.
.SS -F filename
Displays information about the blobfile specified by filename.
.SS -L 
Displays information about the LSA store.
.SS -R
Displays information about the Registry store.
.sp 
The following are valid options and may be specified for any of the blobfiles. 
If no options are specified, the file statistics are displayed by default.
.SS -b
Dumps a map of the fragments in use from the data portion of the blobfile. 
The offset of each page and the status of individual fragments within 
the page is denoted by an x in the corresponding field.
.SS -c	
Checks the blobfile.
.SS -d #	
Deletes key #, where # is the virtual key number. 
Use the -K option to obtain a list of key numbers in use.
.SS -G <pages>
Grows the blob data portion by <pages> number of pages.
.SS -h <id>
Displays information for the hash table identified 
by <id> in binary format.  Valid values are 0, 1 or 2.
.SS -k #
Dumps detailed information about the virtual key # in binary format.
.SS -K	
Dumps a list of the virtual key numbers in use.
.SS -q	
Compresses the blobfile, removing excess free space.
.SS -s	
Dumps a summary of blobfile statistics.
.SS -S	
Displays the number of records in use and the amount of 
space used by the records.
.SH EXAMPLES
To obtain a summary of blobfile statistics for the ACL store, type
the following command at the UNIX system console:
.sp .5
	blobadm -s -A
.SH NOTE
This command must be run as root.