.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH DBGEN.PL 1 "March 31, 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
dbgen.pl \- Random LDIF database creator
.SH SYNOPSIS
.B dbgen.pl
[\fIOPTIONS\fR] \-o output_file \-n number 
.SH DESCRIPTION
Random LDIF database creator.  Used to generate large LDIF files
for use in testing the Directory Server.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
.SH OPTIONS
A summary of options is included below:
.TP
.B \-v 
Verbose output
.TP
.B \-q
Quiet output
.TP
.B \-s suffix 
LDAP suffix. Default is 'dc=example,dc=com'
.TP
.B \-c CN naming style
Naming style for RDN's. Default is UID
.TP
.B \-O organizationalPersons
Organizationalpersons objectClass. Default is inetOrgPerson.
.TP
.B \-p piranha style ACI
Piranha style aci. Default is barracua
.TP
.B \-r seed
Seed number for random number generator
.TP
.B \-g
Print extra entries for orgchart
.TP
.B \-x
Suppress printing of the preamble
.TP
.B \-y
Suppress printing of Organizational Units
.TP
.B \-l
Location of directory containing data files, default is /usr/share/dirsrv/data
.TP
.B \-n number
Number of entries to be generated
.TP
.B \-b number
Beginning number for RDN e.g. uid=1 (ending number is \-n value + beginning number)
.TP
.B \-j number
0 pad numbers used in RDN to this many digits e.g. with 4 1 becomes 0001 (ignored unless \-b number is specified)
.TP
.B \-u
Add groups containing uniquemembers; generate a group for every 100 user entries created that contains the 100 members
.br
.SH AUTHOR
dbgen.pl was written by the 389 Project.
.SH "REPORTING BUGS"
Report bugs to https://pagure.io/389-ds-base/new_issue
.SH COPYRIGHT
Copyright \(co 2001 Sun Microsystems, Inc. Used by permission.
.br
Copyright \(co 2017 Red Hat, Inc.
.br
This manual page was written by Michele Baldessari <michele@pupazzo.org>,
for the Debian project (but may be used by others).
.br
This is free software.  You may redistribute copies of it under the terms of
the Directory Server license found in the LICENSE file of this
software distribution.  This license is essentially the GNU General Public
License version 2 with an exception for plug\(hyin distribution.