[Date Prev][Date Next]
[Chronological]
[Thread]
[Top]
RE: (ITS#8941) Font correction in man pages
This is a multipart message in MIME format.
------=_NextPart_000_020D_01D48C74.C01EDC90
Content-Type: text/plain;
charset="utf-8"
Content-Transfer-Encoding: 7bit
Tested on Ubuntu 16.04:
Linux test 4.4.0-87-generic #110-Ubuntu SMP Tue Jul 18 12:55:35 UTC 2017
x86_64 x86_64 x86_64 GNU/Linux
Using
GNU grops (groff) version 1.22.3
GNU troff (groff) version 1.22.3
We were converting the man pages to html using the following command when we
discovered the issue:
groff -man -T html
And example of the error encountered is:
groff -man -T html man8/slapdn.8 > html8/slapdn.8.html~
stdin:97: warning: can't find font `tt'
stdin:97: warning: can't find font `tt'
I have also attached examples of the resulting html for slapadd with the
existing setting and with the suggested setting. Note the difference of the
example command in the EXAMPLES section.
Thank you,
Jason Trupp
Symas Corporation
(855) LDAP-GUY
-----Original Message-----
From: Howard Chu [mailto:hyc@symas.com]
Sent: Tuesday, December 4, 2018 6:34 PM
To: jtrupp@symas.com; openldap-its@OpenLDAP.org
Subject: Re: (ITS#8941) Font correction in man pages
jtrupp@symas.com wrote:
> Full_Name: Jason Trupp
> Version: 2.4.46
> OS: Ubuntu
> URL: ftp://ftp.openldap.org/incoming/
> Submission from: (NULL) (74.197.13.194)
>
>
> The impacted man pages contain the following (example) .ft setting in
> the "EXAMPLES" section:
>
> .ft tt
> /opt/symas/bin/slapadd \-l ldif .ft
>
> "tt" refers to the mono-spaced font "teletype" which is no longer
> recognized by groff/troff and modern web browsers.
Nonsense. There is no relation between roff language and HTML or web
browsers.
> The affected man pages include:
> ./man8/slapadd.8, ./man8/slapcat.8, ./man8/slapacl.8,
> ./man8/slaptest.8, ./man8/slapdn.8, ./man8/slapindex.8,
> ./man8/slapmodify.8, ./man8/slapd.8, ./man8/slapschema.8,
> ./man8/slapauth.8 and ./man5/ldif.5
>
> The current verbiage should be replaced by:
>
> .EX
> /opt/symas/bin/slapadd \-l ldif .EE
There are no such macros in my local copy of man macros, which is on a
fairly recent (Ubuntu 18) distro.
> Please refer to man 7 groff_man for an explanation of these settings.
> The replacement syntax has been tested and works as expected.
Tested on what platforms? MacOS? BSD? Solaris? What OS revision?
--
-- Howard Chu
CTO, Symas Corp. http://www.symas.com
Director, Highland Sun http://highlandsun.com/hyc/
Chief Architect, OpenLDAP http://www.openldap.org/project/
------=_NextPart_000_020D_01D48C74.C01EDC90
Content-Type: text/html;
name="corrected-slapadd.8.html"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: attachment;
filename="corrected-slapadd.8.html"
<!-- Creator : groff version 1.22.3 -->=0A=
<!-- CreationDate: Tue Dec 4 16:54:54 2018 -->=0A=
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"=0A=
"http://www.w3.org/TR/html4/loose.dtd";>=0A=
<html>=0A=
<head>=0A=
<meta name=3D"generator" content=3D"groff -Thtml, see www.gnu.org">=0A=
<meta http-equiv=3D"Content-Type" content=3D"text/html; =
charset=3DUS-ASCII">=0A=
<meta name=3D"Content-Style" content=3D"text/css">=0A=
<style type=3D"text/css">=0A=
p { margin-top: 0; margin-bottom: 0; vertical-align: top }=0A=
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }=0A=
table { margin-top: 0; margin-bottom: 0; vertical-align: top }=0A=
h1 { text-align: center }=0A=
</style>=0A=
<title>SLAPADD</title>=0A=
=0A=
</head>=0A=
<body>=0A=
=0A=
<h1 align=3D"center">SLAPADD</h1>=0A=
=0A=
<a href=3D"#NAME">NAME</a><br>=0A=
<a href=3D"#SYNOPSIS">SYNOPSIS</a><br>=0A=
<a href=3D"#DESCRIPTION">DESCRIPTION</a><br>=0A=
<a href=3D"#OPTIONS">OPTIONS</a><br>=0A=
<a href=3D"#LIMITATIONS">LIMITATIONS</a><br>=0A=
<a href=3D"#EXAMPLES">EXAMPLES</a><br>=0A=
<a href=3D"#SEE ALSO">SEE ALSO</a><br>=0A=
<a href=3D"#ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</a><br>=0A=
=0A=
<hr>=0A=
=0A=
=0A=
<h2>NAME=0A=
<a name=3D"NAME"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">slapadd −=0A=
Add entries to a SLAPD database</p>=0A=
=0A=
<h2>SYNOPSIS=0A=
<a name=3D"SYNOPSIS"></a>=0A=
</h2>=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: =
1em"><b>/opt/symas/bin/slapadd</b>=0A=
[<b>−b </b><i>suffix</i>] [<b>−c</b>]=0A=
[<b>−d </b><i>debug-level</i>]=0A=
[<b>−f </b><i>slapd.conf</i>]=0A=
[<b>−F </b><i>confdir</i>] [<b>−g</b>]=0A=
[<b>−j </b><i>lineno</i>]=0A=
[<b>−l </b><i>ldif-file</i>]=0A=
[<b>−n </b><i>dbnum</i>]=0A=
[<b>−o </b><i>option</i>[<b>=3D</b><i>value</i>]]=0A=
[<b>−q</b>] [<b>−s</b>]=0A=
[<b>−S </b><i>SID</i>] [<b>−u</b>]=0A=
[<b>−v</b>] [<b>−w</b>]</p>=0A=
=0A=
<h2>DESCRIPTION=0A=
<a name=3D"DESCRIPTION"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>Slapadd</b>=0A=
is used to add entries specified in LDAP Directory=0A=
Interchange Format (LDIF) to a <b>slapd</b>(8) database. It=0A=
opens the given database determined by the database number=0A=
or suffix and adds entries corresponding to the provided=0A=
LDIF to the database. Databases configured as=0A=
<b>subordinate</b> of this one are also updated, unless=0A=
<b>−g</b> is specified. The LDIF input is read from=0A=
standard input or the specified file.</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">All files=0A=
eventually created by <b>slapadd</b> will belong to the=0A=
identity <b>slapadd</b> is run as, so make sure you either=0A=
run <b>slapadd</b> with the same identity <b>slapd</b>(8)=0A=
will be run as (see option <b>−u</b> in=0A=
<b>slapd</b>(8)), or change file ownership before running=0A=
<b>slapd</b>(8).</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">Note: slapadd=0A=
will also perform the relevant indexing whilst adding the=0A=
database if any are configured. For specific details, please=0A=
see <b>slapindex</b>(8).</p>=0A=
=0A=
<h2>OPTIONS=0A=
<a name=3D"OPTIONS"></a>=0A=
</h2>=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: =
1em"><b>−b </b><i>suffix</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Use the specified <i>suffix</i>=0A=
to determine which database to add entries to. The=0A=
<b>−b</b> cannot be used in conjunction with the=0A=
<b>−n</b> option.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−c</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"56%">=0A=
=0A=
=0A=
<p>enable continue (ignore errors) mode.</p></td>=0A=
<td width=3D"22%">=0A=
</td></tr>=0A=
</table>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−d </b><i>debug-level</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">enable debugging messages as=0A=
defined by the specified <i>debug-level</i>; see=0A=
<b>slapd</b>(8) for details.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−f </b><i>slapd.conf</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">specify an alternative=0A=
<b>slapd.conf</b>(5) file.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−F </b><i>confdir</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">specify a config directory. If=0A=
both <b>−f</b> and <b>−F</b> are specified, the=0A=
config file will be read and converted to config directory=0A=
format and written to the specified directory. If neither=0A=
option is specified, an attempt to read the default config=0A=
directory will be made before trying to use the default=0A=
config file. If a valid config directory exists then the=0A=
default config file is ignored. If dry-run mode is also=0A=
specified, no conversion will occur.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−g</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p>disable subordinate gluing. Only the specified database=0A=
will be processed, and not its glued subordinates (if=0A=
any).</p> </td></tr>=0A=
</table>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−j </b><i>lineno</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Jump to the specified line=0A=
number in the LDIF file before processing any entries. This=0A=
allows a load that was aborted due to errors in the input=0A=
LDIF to be resumed after the errors are corrected.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−l </b><i>ldif-file</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Read LDIF from the specified=0A=
file instead of standard input.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−n </b><i>dbnum</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Add entries to the=0A=
<i>dbnum</i>-th database listed in the configuration file.=0A=
The <b>−n</b> cannot be used in conjunction with the=0A=
<b>−b</b> option. To populate the config database=0A=
<b>slapd−config</b>(5), use <b>−n 0</b> as it is=0A=
always the first database. It must physically exist on the=0A=
filesystem prior to this, however.</p>=0A=
=0A=
=0A=
<p =
style=3D"margin-left:11%;"><b>−o </b><i>option</i>[<b>=3D</b><=
i>value</i>]</p>=0A=
=0A=
<p style=3D"margin-left:22%;">Specify an <i>option</i> with=0A=
a(n optional) <i>value</i>. Possible generic options/values=0A=
are:</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">syslog=3D<subsystems>=0A=
(see ’−s’ in slapd(8)) <br>=0A=
syslog−level=3D<level> (see ’−S’=0A=
in slapd(8)) <br>=0A=
syslog−user=3D<user> (see ’−l’=0A=
in slapd(8))</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">schema-check=3D{yes|no}=0A=
<br>=0A=
value-check=3D{yes|no}</p>=0A=
=0A=
<p style=3D"margin-left:22%; margin-top: 1em">The=0A=
<i>schema−check</i> option toggles schema checking=0A=
(default on); <br>=0A=
the <i>value−check</i> option toggles value checking=0A=
(default off). <br>=0A=
The latter is incompatible with <b>-q</b>.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−q</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p>enable quick (fewer integrity checks) mode. Does fewer=0A=
consistency checks</p></td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">on the input data, and no=0A=
consistency checks when writing the database. <br>=0A=
Improves the load time but if any errors or interruptions=0A=
occur the resulting <br>=0A=
database will be unusable.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em"><b>−s</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em">disable schema checking. This=0A=
option is intended to be used when loading</p></td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">databases containing special=0A=
objects, such as fractional objects on a <br>=0A=
partial replica. Loading normal objects which do not conform=0A=
to <br>=0A=
schema may result in unexpected and ill behavior.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"9%">=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em"><b>−S </b><i>SID</i></p> </td>=0A=
<td width=3D"2%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em">Server ID to use in generated=0A=
entryCSN. Also used for contextCSN</p></td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">if <b>−w</b> is set as=0A=
well. Defaults to <b>0</b>.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em"><b>−u</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"69%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em">enable dry-run (don’t=0A=
write to backend) mode.</p></td>=0A=
<td width=3D"9%">=0A=
</td></tr>=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−v</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"69%">=0A=
=0A=
=0A=
<p>enable verbose mode.</p></td>=0A=
<td width=3D"9%">=0A=
</td></tr>=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−w</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"69%">=0A=
=0A=
=0A=
<p>write syncrepl context information.</p></td>=0A=
<td width=3D"9%">=0A=
</td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">After all entries are added,=0A=
the contextCSN <br>=0A=
will be updated with the greatest CSN in the database.</p>=0A=
=0A=
<h2>LIMITATIONS=0A=
<a name=3D"LIMITATIONS"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">Your=0A=
<b>slapd</b>(8) should not be running when you do this to=0A=
ensure consistency of the database.</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>slapadd</b>=0A=
may not provide naming or schema checks. It is advisable to=0A=
use <b>ldapadd</b>(1) when adding new entries into an=0A=
existing directory.</p>=0A=
=0A=
<h2>EXAMPLES=0A=
<a name=3D"EXAMPLES"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">To import the=0A=
entries specified in file <b>ldif</b> into your=0A=
<b>slapd</b>(8) database give the command:</p>=0A=
=0A=
<pre style=3D"margin-left:11%; margin-top: 1em"> =
/opt/symas/bin/slapadd −l ldif</pre>=0A=
=0A=
=0A=
<h2>SEE ALSO=0A=
<a name=3D"SEE ALSO"></a>=0A=
</h2>=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>ldap</b>(3),=0A=
<b>ldif</b>(5), <b>slapcat</b>(8), <b>slapindex</b>(8),=0A=
<b>ldapadd</b>(1), <b>slapd</b>(8)</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">"OpenLDAP=0A=
Administrator’s Guide"=0A=
(http://www.OpenLDAP.org/doc/admin/)</p>=0A=
=0A=
<h2>ACKNOWLEDGEMENTS=0A=
<a name=3D"ACKNOWLEDGEMENTS"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>OpenLDAP=0A=
Software</b> is developed and maintained by The OpenLDAP=0A=
Project <http://www.openldap.org/>. <b>OpenLDAP=0A=
Software</b> is derived from the University of Michigan LDAP=0A=
3.3 Release.</p>=0A=
<hr>=0A=
</body>=0A=
</html>=0A=
------=_NextPart_000_020D_01D48C74.C01EDC90
Content-Type: text/html;
name="current-slapadd.8.html"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: attachment;
filename="current-slapadd.8.html"
<!-- Creator : groff version 1.22.3 -->=0A=
<!-- CreationDate: Mon Dec 3 22:00:51 2018 -->=0A=
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"=0A=
"http://www.w3.org/TR/html4/loose.dtd";>=0A=
<html>=0A=
<head>=0A=
<meta name=3D"generator" content=3D"groff -Thtml, see www.gnu.org">=0A=
<meta http-equiv=3D"Content-Type" content=3D"text/html; =
charset=3DUS-ASCII">=0A=
<meta name=3D"Content-Style" content=3D"text/css">=0A=
<style type=3D"text/css">=0A=
p { margin-top: 0; margin-bottom: 0; vertical-align: top }=0A=
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }=0A=
table { margin-top: 0; margin-bottom: 0; vertical-align: top }=0A=
h1 { text-align: center }=0A=
</style>=0A=
<title>SLAPADD</title>=0A=
=0A=
</head>=0A=
<body>=0A=
=0A=
<h1 align=3D"center">SLAPADD</h1>=0A=
=0A=
<a href=3D"#NAME">NAME</a><br>=0A=
<a href=3D"#SYNOPSIS">SYNOPSIS</a><br>=0A=
<a href=3D"#DESCRIPTION">DESCRIPTION</a><br>=0A=
<a href=3D"#OPTIONS">OPTIONS</a><br>=0A=
<a href=3D"#LIMITATIONS">LIMITATIONS</a><br>=0A=
<a href=3D"#EXAMPLES">EXAMPLES</a><br>=0A=
<a href=3D"#SEE ALSO">SEE ALSO</a><br>=0A=
<a href=3D"#ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</a><br>=0A=
=0A=
<hr>=0A=
=0A=
=0A=
<h2>NAME=0A=
<a name=3D"NAME"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">slapadd −=0A=
Add entries to a SLAPD database</p>=0A=
=0A=
<h2>SYNOPSIS=0A=
<a name=3D"SYNOPSIS"></a>=0A=
</h2>=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: =
1em"><b>/opt/symas/bin/slapadd</b>=0A=
[<b>−b </b><i>suffix</i>] [<b>−c</b>]=0A=
[<b>−d </b><i>debug-level</i>]=0A=
[<b>−f </b><i>slapd.conf</i>]=0A=
[<b>−F </b><i>confdir</i>] [<b>−g</b>]=0A=
[<b>−j </b><i>lineno</i>]=0A=
[<b>−l </b><i>ldif-file</i>]=0A=
[<b>−n </b><i>dbnum</i>]=0A=
[<b>−o </b><i>option</i>[<b>=3D</b><i>value</i>]]=0A=
[<b>−q</b>] [<b>−s</b>]=0A=
[<b>−S </b><i>SID</i>] [<b>−u</b>]=0A=
[<b>−v</b>] [<b>−w</b>]</p>=0A=
=0A=
<h2>DESCRIPTION=0A=
<a name=3D"DESCRIPTION"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>Slapadd</b>=0A=
is used to add entries specified in LDAP Directory=0A=
Interchange Format (LDIF) to a <b>slapd</b>(8) database. It=0A=
opens the given database determined by the database number=0A=
or suffix and adds entries corresponding to the provided=0A=
LDIF to the database. Databases configured as=0A=
<b>subordinate</b> of this one are also updated, unless=0A=
<b>−g</b> is specified. The LDIF input is read from=0A=
standard input or the specified file.</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">All files=0A=
eventually created by <b>slapadd</b> will belong to the=0A=
identity <b>slapadd</b> is run as, so make sure you either=0A=
run <b>slapadd</b> with the same identity <b>slapd</b>(8)=0A=
will be run as (see option <b>−u</b> in=0A=
<b>slapd</b>(8)), or change file ownership before running=0A=
<b>slapd</b>(8).</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">Note: slapadd=0A=
will also perform the relevant indexing whilst adding the=0A=
database if any are configured. For specific details, please=0A=
see <b>slapindex</b>(8).</p>=0A=
=0A=
<h2>OPTIONS=0A=
<a name=3D"OPTIONS"></a>=0A=
</h2>=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: =
1em"><b>−b </b><i>suffix</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Use the specified <i>suffix</i>=0A=
to determine which database to add entries to. The=0A=
<b>−b</b> cannot be used in conjunction with the=0A=
<b>−n</b> option.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−c</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"56%">=0A=
=0A=
=0A=
<p>enable continue (ignore errors) mode.</p></td>=0A=
<td width=3D"22%">=0A=
</td></tr>=0A=
</table>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−d </b><i>debug-level</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">enable debugging messages as=0A=
defined by the specified <i>debug-level</i>; see=0A=
<b>slapd</b>(8) for details.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−f </b><i>slapd.conf</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">specify an alternative=0A=
<b>slapd.conf</b>(5) file.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−F </b><i>confdir</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">specify a config directory. If=0A=
both <b>−f</b> and <b>−F</b> are specified, the=0A=
config file will be read and converted to config directory=0A=
format and written to the specified directory. If neither=0A=
option is specified, an attempt to read the default config=0A=
directory will be made before trying to use the default=0A=
config file. If a valid config directory exists then the=0A=
default config file is ignored. If dry-run mode is also=0A=
specified, no conversion will occur.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−g</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p>disable subordinate gluing. Only the specified database=0A=
will be processed, and not its glued subordinates (if=0A=
any).</p> </td></tr>=0A=
</table>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−j </b><i>lineno</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Jump to the specified line=0A=
number in the LDIF file before processing any entries. This=0A=
allows a load that was aborted due to errors in the input=0A=
LDIF to be resumed after the errors are corrected.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−l </b><i>ldif-file</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Read LDIF from the specified=0A=
file instead of standard input.</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%;"><b>−n </b><i>dbnum</i></p>=0A=
=0A=
<p style=3D"margin-left:22%;">Add entries to the=0A=
<i>dbnum</i>-th database listed in the configuration file.=0A=
The <b>−n</b> cannot be used in conjunction with the=0A=
<b>−b</b> option. To populate the config database=0A=
<b>slapd−config</b>(5), use <b>−n 0</b> as it is=0A=
always the first database. It must physically exist on the=0A=
filesystem prior to this, however.</p>=0A=
=0A=
=0A=
<p =
style=3D"margin-left:11%;"><b>−o </b><i>option</i>[<b>=3D</b><=
i>value</i>]</p>=0A=
=0A=
<p style=3D"margin-left:22%;">Specify an <i>option</i> with=0A=
a(n optional) <i>value</i>. Possible generic options/values=0A=
are:</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">syslog=3D<subsystems>=0A=
(see ’−s’ in slapd(8)) <br>=0A=
syslog−level=3D<level> (see ’−S’=0A=
in slapd(8)) <br>=0A=
syslog−user=3D<user> (see ’−l’=0A=
in slapd(8))</p>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">schema-check=3D{yes|no}=0A=
<br>=0A=
value-check=3D{yes|no}</p>=0A=
=0A=
<p style=3D"margin-left:22%; margin-top: 1em">The=0A=
<i>schema−check</i> option toggles schema checking=0A=
(default on); <br>=0A=
the <i>value−check</i> option toggles value checking=0A=
(default off). <br>=0A=
The latter is incompatible with <b>-q</b>.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−q</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p>enable quick (fewer integrity checks) mode. Does fewer=0A=
consistency checks</p></td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">on the input data, and no=0A=
consistency checks when writing the database. <br>=0A=
Improves the load time but if any errors or interruptions=0A=
occur the resulting <br>=0A=
database will be unusable.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em"><b>−s</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em">disable schema checking. This=0A=
option is intended to be used when loading</p></td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">databases containing special=0A=
objects, such as fractional objects on a <br>=0A=
partial replica. Loading normal objects which do not conform=0A=
to <br>=0A=
schema may result in unexpected and ill behavior.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"9%">=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em"><b>−S </b><i>SID</i></p> </td>=0A=
<td width=3D"2%"></td>=0A=
<td width=3D"78%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em">Server ID to use in generated=0A=
entryCSN. Also used for contextCSN</p></td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">if <b>−w</b> is set as=0A=
well. Defaults to <b>0</b>.</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em"><b>−u</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"69%">=0A=
=0A=
=0A=
<p style=3D"margin-top: 1em">enable dry-run (don’t=0A=
write to backend) mode.</p></td>=0A=
<td width=3D"9%">=0A=
</td></tr>=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−v</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"69%">=0A=
=0A=
=0A=
<p>enable verbose mode.</p></td>=0A=
<td width=3D"9%">=0A=
</td></tr>=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"11%"></td>=0A=
<td width=3D"3%">=0A=
=0A=
=0A=
<p><b>−w</b></p></td>=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"69%">=0A=
=0A=
=0A=
<p>write syncrepl context information.</p></td>=0A=
<td width=3D"9%">=0A=
</td></tr>=0A=
</table>=0A=
=0A=
<p style=3D"margin-left:22%;">After all entries are added,=0A=
the contextCSN <br>=0A=
will be updated with the greatest CSN in the database.</p>=0A=
=0A=
<h2>LIMITATIONS=0A=
<a name=3D"LIMITATIONS"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">Your=0A=
<b>slapd</b>(8) should not be running when you do this to=0A=
ensure consistency of the database.</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>slapadd</b>=0A=
may not provide naming or schema checks. It is advisable to=0A=
use <b>ldapadd</b>(1) when adding new entries into an=0A=
existing directory.</p>=0A=
=0A=
<h2>EXAMPLES=0A=
<a name=3D"EXAMPLES"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">To import the=0A=
entries specified in file <b>ldif</b> into your=0A=
<b>slapd</b>(8) database give the command:</p>=0A=
=0A=
<table width=3D"100%" border=3D"0" rules=3D"none" frame=3D"void"=0A=
cellspacing=3D"0" cellpadding=3D"0">=0A=
<tr valign=3D"top" align=3D"left">=0A=
<td width=3D"8%"></td>=0A=
<td width=3D"92%">=0A=
=0A=
=0A=
<p>/opt/symas/bin/slapadd −l ldif</p></td></tr>=0A=
</table>=0A=
=0A=
<h2>SEE ALSO=0A=
<a name=3D"SEE ALSO"></a>=0A=
</h2>=0A=
=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>ldap</b>(3),=0A=
<b>ldif</b>(5), <b>slapcat</b>(8), <b>slapindex</b>(8),=0A=
<b>ldapadd</b>(1), <b>slapd</b>(8)</p>=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em">"OpenLDAP=0A=
Administrator’s Guide"=0A=
(http://www.OpenLDAP.org/doc/admin/)</p>=0A=
=0A=
<h2>ACKNOWLEDGEMENTS=0A=
<a name=3D"ACKNOWLEDGEMENTS"></a>=0A=
</h2>=0A=
=0A=
=0A=
<p style=3D"margin-left:11%; margin-top: 1em"><b>OpenLDAP=0A=
Software</b> is developed and maintained by The OpenLDAP=0A=
Project <http://www.openldap.org/>. <b>OpenLDAP=0A=
Software</b> is derived from the University of Michigan LDAP=0A=
3.3 Release.</p>=0A=
<hr>=0A=
</body>=0A=
</html>=0A=
------=_NextPart_000_020D_01D48C74.C01EDC90--