git.sur5r.net Git - openldap/blob - doc/man/man8/slapadd.8

   1 .TH SLAPADD 8C "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-2002 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .SH NAME
   6 slapadd \- Add entries to a SLAPD database
   7 .SH SYNOPSIS
   8 .B SBINDIR/slapadd
   9 .B [\-v]
  10 .B [\-c]
  11 .B [\-d level]
  12 .B [\-b suffix]
  13 .B [\-n dbnum]
  14 .B [\-f slapd.conf]
  15 .B [\-l ldif-file]
  16 .B
  17 .LP
  18 .SH DESCRIPTION
  19 .LP
  20 .B Slapadd
  21 is used to add entries specified in LDAP Directory Interchange Format
  22 (LDIF) to a
  23 .BR slapd (8)
  24 database.
  25 It opens the given database determined by the database number or
  26 suffix and adds entries corresponding to the provided LDIF to
  27 the database.  The LDIF input is read from standard input or
  28 the specified file.
  29 .LP
  30 As
  31 .B slapadd
  32 is designed to accept LDIF in database order, as produced by
  33 .BR slapcat (8),
  34 it does not verify that superior entries exist before
  35 adding an entry, does not perform all user and system
  36 schema checks, and does not maintain operational
  37 attributes (such as createTimeStamp and modifiersName).
  38 .SH OPTIONS
  39 .TP
  40 .B \-v
  41 enable verbose mode.
  42 .TP
  43 .B \-c
  44 enable continue (ignore errors) mode.
  45 .TP
  46 .BI \-d " level"
  47 enable debugging messages as defined by the specified
  48 .IR level .
  49 .TP
  50 .BI \-b " suffix"
  51 Use the specified \fIsuffix\fR to determine which database to
  52 add entries to.  The \-b cannot be used in conjunction
  53 with the
  54 .B \-n
  55 option.
  56 .TP
  57 .BI \-n " dbnum"
  58 Add entries to the \fIdbnum\fR\-th database listed in the
  59 configuration file.  The
  60 .B \-n
  61 cannot be used in conjunction with the
  62 .B \-b
  63 option.
  64 .TP
  65 .BI \-f " slapd.conf"
  66 specify an alternative
  67 .BR slapd.conf (5)
  68 file.
  69 .TP
  70 .BI \-l " ldif-file"
  71 Read LDIF from the specified file instead of standard input.
  72 .SH LIMITATIONS
  73 Your
  74 .BR slapd (8)
  75 should not be running
  76 when you do this to ensure consistency of the database.
  77 .LP
  78 .B slapadd
  79 may not provide naming or schema checks.  It is advisable to
  80 use
  81 .BR ldapadd (1)
  82 when adding new entries into an existing directory.
  83 .SH EXAMPLES
  84 To import a entries specified in file
  85 .B ldif
  86 into your
  87 .BR slapd (8)
  88 database give the command:
  89 .LP
  90 .nf
  91 .ft tt
  92         SBINDIR/slapadd -l ldif
  93 .ft
  94 .fi
  95 .SH "SEE ALSO"
  96 .BR ldap (3),
  97 .BR ldif (5),
  98 .BR slapcat (8),
  99 .BR ldapadd (1),
 100 .BR slapd (8)
 101 .LP
 102 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
 103 .SH ACKNOWLEDGEMENTS
 104 .B      OpenLDAP
 105 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
 106 .B      OpenLDAP
 107 is derived from University of Michigan LDAP 3.3 Release.