Chapter 26   dbscan


The dbscan tool analyzes and extracts information from an iPlanet Directory Server database file. Database files use the .db2 and .db3 extensions in their filename, depending on the version of the iPlanet Directory Server.

This chapter contains the following section:

• Syntax

• Options

Command Usage

---

The dbscan tool analyzes "raw" database files and extracts information about the entries stored in the directory. One format of the output generates the LDIF representation of directory contents. You can also use this tool to create index files of the database.

Syntax

The dbscan tool has the following command-line syntax:

dbscan [ options ] -f filename

Where:

• options are the command line options described in Table 26-1.

• filename specifies the database filename and path. The tool accepts database files with either .db2 or .db3 extensions.

You will need redirect to redirect the standard output to a file (> outputFile ) to save the output of the dbscan tool.

Options

The dbscan options and parameters are described in the following table.

Table 26-1    Command-Line Options for the dbscan Tool 

Option	Parameter	Purpose
-f	filename	Specify the database file to analyze.
-i		Analyze the database file to generate its index file in the output.
-e		Analyze the database file to generate a corresponding entry file. The output is in the id2entry format.
-l	maxLength	Specify the maximum length of ID lists to display. Longer lists will be truncated at the maxLength number of IDs. When this option is not specified, the default maximum length is 4096.
-n		Specify that only ID list lengths be displayed, not their contents.
-G	minSize	Specify that only index entries with more than minSize IDs should be displayed in the output. This option is only effective when used with the -n option.
-r		Show libdb record numbers in the output.
-k	key	Look for and output only the specified key in the database.