Previous      Contents      Index      Next
Sun ONE Directory Server Resource Kit 5.2 Tools Reference

Chapter 29
The Database File Analyzer Tool

The dbscan tool analyzes and extracts information from a Sun™ ONE Directory Server database file. This chapter provides instructions on how to use dbscan. It contains the following sections:

Overview
Command Usage

---

Overview

The dbscan tool analyzes and extracts information from a Directory Server database file. Database files use the .db2 and .db3 extensions in their filename, depending on the version of Directory Server. The tool analyzes these files, extracting information about entries in the Directory Server. The DSRK includes the tool in the DSRK_base/bin/dsrk52 directory.

---

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 LDAP Data Interchange Format (LDIF ) representation of directory contents. You can also use this tool to create index files of the database.

Syntax

The syntax of the dbscan tool on the command-line takes the following form:

dbscan [ options ] -f filename

Where:

options are the command-line options described in Options.
filename specifies the database filename and path. The tool accepts database files with either .db2 or .db3 extensions.

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

Options

The dbscan options and parameters are described in Table 29-1.

Table 29-1  Command-Line Options for dbscan 

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.

Previous      Contents      Index      Next

---

Copyright 2004 Sun Microsystems, Inc. All rights reserved.