~ttx/openldap/lucid-gssapi-495418

« back to all changes in this revision

Viewing changes to doc/man/man8/slapadd.8

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek, Updated debconf translations
  • Date: 2009-07-28 10:17:15 UTC
  • mfrom: (1.1.4 upstream) (0.2.2 sid)
  • mto: (0.2.4 sid)
  • mto: This revision was merged to the branch mainline in revision 16.
  • Revision ID: james.westby@ubuntu.com-20090728101715-epwmqmsk0d3h22k3
* New upstream version.
  - Fixes FTBFS on ia64 with -fPIE. Closes: #524770.
  - Fixes some TLS issues with GnuTLS.  Closes: #505191.
* Update priority of libldap-2.4-2 to match the archive override.
* Add the missing ldapexop and ldapurl tools to ldap-utils, as well as the
  ldapurl(1) manpage.  Thanks to Peter Marschall for the patch.
  Closes: #496749.
* Bump build-dependency on debhelper to 6 instead of 5, since that's
  what we're using.  Closes: #498116.
* Set the default SLAPD_SERVICES to ldap:/// ldapi:///, instead of using
  the built-in default of ldap:/// only.
* Build-depend on libltdl-dev | libltdl3-dev (>= 1.4.3), for the package
  name change.  Closes: #522965.

[ Updated debconf translations ]
* Spanish, thanks to Francisco Javier Cuadrado <fcocuadrado@gmail.com>.
  Closes: #521804.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.TH SLAPADD 8C "RELEASEDATE" "OpenLDAP LDVERSION"
2
 
.\" $OpenLDAP: pkg/ldap/doc/man/man8/slapadd.8,v 1.34.2.8 2008/02/11 23:26:40 kurt Exp $
3
 
.\" Copyright 1998-2008 The OpenLDAP Foundation All Rights Reserved.
 
2
.\" Copyright 1998-2009 The OpenLDAP Foundation All Rights Reserved.
4
3
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
 
4
.\" $OpenLDAP: pkg/ldap/doc/man/man8/slapadd.8,v 1.34.2.13 2009/06/08 18:01:09 quanah Exp $
5
5
.SH NAME
6
6
slapadd \- Add entries to a SLAPD database
7
7
.SH SYNOPSIS
8
8
.B SBINDIR/slapadd
9
 
.B [\-b suffix]
10
 
.B [\-c]
11
 
.B [\-d level]
12
 
.B [\-f slapd.conf]
13
 
.B [\-F confdir]
14
 
.B [\-g]
15
 
.B [\-j lineno]
16
 
.B [\-l ldif-file]
17
 
.B [\-n dbnum]
18
 
.B [\-o name[=value]]
19
 
.B [\-q]
20
 
.B [\-s]
21
 
.B [\-S SID]
22
 
.B [\-u]
23
 
.B [\-v]
24
 
.B [\-w]
 
9
[\c
 
10
.BI \-b \ suffix\fR]
 
11
[\c
 
12
.BR \-c ]
 
13
[\c
 
14
.BI \-d \ debug-level\fR]
 
15
[\c
 
16
.BI \-f \ slapd.conf\fR]
 
17
[\c
 
18
.BI \-F \ confdir\fR]
 
19
[\c
 
20
.BR \-g ]
 
21
[\c
 
22
.BI \-j \ lineno\fR]
 
23
[\c
 
24
.BI \-l \ ldif-file\fR]
 
25
[\c
 
26
.BI \-n \ dbnum\fR]
 
27
[\c
 
28
.BI \-o \ option\fR[ = value\fR]]
 
29
[\c
 
30
.BR \-q ]
 
31
[\c
 
32
.BR \-s ]
 
33
[\c
 
34
.BI \-S \ SID\fR]
 
35
[\c
 
36
.BR \-u ]
 
37
[\c
 
38
.BR \-v ]
 
39
[\c
 
40
.BR \-w ]
25
41
.SH DESCRIPTION
26
42
.LP
27
43
.B Slapadd
34
50
the database.
35
51
Databases configured as
36
52
.B subordinate
37
 
of this one are also updated, unless \fB-g\fP is specified.
 
53
of this one are also updated, unless \fB\-g\fP is specified.
38
54
The LDIF input is read from standard input or the specified file.
39
55
 
40
56
All files eventually created by
51
67
.BR slapd (8)),
52
68
or change file ownership before running
53
69
.BR slapd (8).
 
70
 
 
71
Note: slapadd will also perform the relevant indexing whilst adding the database if
 
72
any are configured. For specfic details, please see 
 
73
.BR slapindex (8).
54
74
.SH OPTIONS
55
75
.TP
56
 
.BI \-b " suffix" 
 
76
.BI \-b \ suffix 
57
77
Use the specified \fIsuffix\fR to determine which database to
58
 
add entries to.  The \-b cannot be used in conjunction
 
78
add entries to.  The \fB\-b\fP cannot be used in conjunction
59
79
with the
60
80
.B \-n
61
81
option.
63
83
.B \-c
64
84
enable continue (ignore errors) mode.
65
85
.TP
66
 
.BI \-d " level"
 
86
.BI \-d \ debug-level
67
87
enable debugging messages as defined by the specified
68
 
.IR level ;
 
88
.IR debug-level ;
69
89
see
70
90
.BR slapd (8)
71
91
for details.
72
92
.TP
73
 
.BI \-f " slapd.conf"
 
93
.BI \-f \ slapd.conf
74
94
specify an alternative
75
95
.BR slapd.conf (5)
76
96
file.
77
97
.TP
78
 
.BI \-F " confdir"
 
98
.BI \-F \ confdir
79
99
specify a config directory.
80
100
If both
81
 
.B -f
 
101
.B \-f
82
102
and
83
 
.B -F
 
103
.B \-F
84
104
are specified, the config file will be read and converted to
85
105
config directory format and written to the specified directory.
86
106
If neither option is specified, an attempt to read the
87
107
default config directory will be made before trying to use the default
88
108
config file. If a valid config directory exists then the
89
 
default config file is ignored. If dryrun mode is also specified,
 
109
default config file is ignored. If dry-run mode is also specified,
90
110
no conversion will occur.
91
111
.TP
92
112
.B \-g
93
113
disable subordinate gluing.  Only the specified database will be
94
114
processed, and not its glued subordinates (if any).
95
115
.TP
96
 
.BI \-j " lineno"
 
116
.BI \-j \ lineno
97
117
Jump to the specified line number in the LDIF file before processing
98
118
any entries. This allows a load that was aborted due to errors in the
99
119
input LDIF to be resumed after the errors are corrected.
100
120
.TP
101
 
.BI \-l " ldif-file"
 
121
.BI \-l \ ldif-file
102
122
Read LDIF from the specified file instead of standard input.
103
123
.TP
104
 
.BI \-n " dbnum"
105
 
Add entries to the \fIdbnum\fR\-th database listed in the
 
124
.BI \-n \ dbnum
 
125
Add entries to the \fIdbnum\fR-th database listed in the
106
126
configuration file.  The
107
127
.B \-n
108
128
cannot be used in conjunction with the
109
129
.B \-b
110
130
option.
 
131
To populate the config database
 
132
.BR slapd\-config (5),
 
133
use 
 
134
.B \-n 0
 
135
as it is always the first database. It must physically exist
 
136
on the filesystem prior to this, however.
111
137
.TP
112
 
.BI \-o " option[=value]"
 
138
.BI \-o \ option\fR[ = value\fR]
113
139
Specify an
114
 
.BR option
 
140
.I option
115
141
with a(n optional)
116
 
.BR value .
 
142
.IR value .
117
143
Possible generic options/values are:
118
144
.LP
119
145
.nf
120
146
              syslog=<subsystems>  (see `\-s' in slapd(8))
121
 
              syslog-level=<level> (see `\-S' in slapd(8))
122
 
              syslog-user=<user>   (see `\-l' in slapd(8))
 
147
              syslog\-level=<level> (see `\-S' in slapd(8))
 
148
              syslog\-user=<user>   (see `\-l' in slapd(8))
123
149
 
124
150
.fi
125
151
.TP
129
155
Improves the load time but if any errors or interruptions occur the resulting
130
156
database will be unusable.
131
157
.TP
132
 
.B -s
 
158
.B \-s
133
159
disable schema checking.  This option is intended to be used when loading
134
160
databases containing special objects, such as fractional objects on a
135
161
partial replica.  Loading normal objects which do not conform to
136
162
schema may result in unexpected and ill behavior.
137
163
.TP
138
 
.B \-S " SID"
 
164
.BI \-S \ SID
139
165
Server ID to use in generated entryCSN.  Also used for contextCSN
140
 
if `\-w' is set as well.  Defaults to 0.
 
166
if \fB\-w\fP is set as well.  Defaults to \fB0\fP.
141
167
.TP
142
168
.B \-u
143
169
enable dry-run (don't write to backend) mode.
169
195
.LP
170
196
.nf
171
197
.ft tt
172
 
        SBINDIR/slapadd -l ldif
 
198
        SBINDIR/slapadd \-l ldif
173
199
.ft
174
200
.fi
175
201
.SH "SEE ALSO"
176
202
.BR ldap (3),
177
203
.BR ldif (5),
178
204
.BR slapcat (8),
 
205
.BR slapindex (8),
179
206
.BR ldapadd (1),
180
207
.BR slapd (8)
181
208
.LP