Ignore:
Timestamp:
May 27, 2009, 9:08:03 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update 3.2 branch to 3.2.8 docs

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.2.x/docs/manpages/ldbedit.1

    r229 r231  
    11.\"     Title: ldbedit
    2 .\"    Author:
    3 .\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
    4 .\"      Date: 12/19/2008
     2.\"    Author: [see the "AUTHOR" section]
     3.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
     4.\"      Date: 02/03/2009
    55.\"    Manual: User Commands
    66.\"    Source: Samba 3.2
     7.\"  Language: English
    78.\"
    8 .TH "LDBEDIT" "1" "12/19/2008" "Samba 3\.2" "User Commands"
     9.TH "LDBEDIT" "1" "02/03/2009" "Samba 3\&.2" "User Commands"
     10.\" -----------------------------------------------------------------
     11.\" * (re)Define some macros
     12.\" -----------------------------------------------------------------
     13.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     14.\" toupper - uppercase a string (locale-aware)
     15.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     16.de toupper
     17.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
     18\\$*
     19.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
     20..
     21.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     22.\" SH-xref - format a cross-reference to an SH section
     23.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     24.de SH-xref
     25.ie n \{\
     26.\}
     27.toupper \\$*
     28.el \{\
     29\\$*
     30.\}
     31..
     32.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     33.\" SH - level-one heading that works better for non-TTY output
     34.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     35.de1 SH
     36.\" put an extra blank line of space above the head in non-TTY output
     37.if t \{\
     38.sp 1
     39.\}
     40.sp \\n[PD]u
     41.nr an-level 1
     42.set-an-margin
     43.nr an-prevailing-indent \\n[IN]
     44.fi
     45.in \\n[an-margin]u
     46.ti 0
     47.HTML-TAG ".NH \\n[an-level]"
     48.it 1 an-trap
     49.nr an-no-space-flag 1
     50.nr an-break-flag 1
     51\." make the size of the head bigger
     52.ps +3
     53.ft B
     54.ne (2v + 1u)
     55.ie n \{\
     56.\" if n (TTY output), use uppercase
     57.toupper \\$*
     58.\}
     59.el \{\
     60.nr an-break-flag 0
     61.\" if not n (not TTY), use normal case (not uppercase)
     62\\$1
     63.in \\n[an-margin]u
     64.ti 0
     65.\" if not n (not TTY), put a border/line under subheading
     66.sp -.6
     67\l'\n(.lu'
     68.\}
     69..
     70.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     71.\" SS - level-two heading that works better for non-TTY output
     72.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     73.de1 SS
     74.sp \\n[PD]u
     75.nr an-level 1
     76.set-an-margin
     77.nr an-prevailing-indent \\n[IN]
     78.fi
     79.in \\n[IN]u
     80.ti \\n[SN]u
     81.it 1 an-trap
     82.nr an-no-space-flag 1
     83.nr an-break-flag 1
     84.ps \\n[PS-SS]u
     85\." make the size of the head bigger
     86.ps +2
     87.ft B
     88.ne (2v + 1u)
     89.if \\n[.$] \&\\$*
     90..
     91.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     92.\" BB/BE - put background/screen (filled box) around block of text
     93.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     94.de BB
     95.if t \{\
     96.sp -.5
     97.br
     98.in +2n
     99.ll -2n
     100.gcolor red
     101.di BX
     102.\}
     103..
     104.de EB
     105.if t \{\
     106.if "\\$2"adjust-for-leading-newline" \{\
     107.sp -1
     108.\}
     109.br
     110.di
     111.in
     112.ll
     113.gcolor
     114.nr BW \\n(.lu-\\n(.i
     115.nr BH \\n(dn+.5v
     116.ne \\n(BHu+.5v
     117.ie "\\$2"adjust-for-leading-newline" \{\
     118\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
     119.\}
     120.el \{\
     121\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
     122.\}
     123.in 0
     124.sp -.5v
     125.nf
     126.BX
     127.in
     128.sp .5v
     129.fi
     130.\}
     131..
     132.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     133.\" BM/EM - put colored marker in margin next to block of text
     134.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     135.de BM
     136.if t \{\
     137.br
     138.ll -2n
     139.gcolor red
     140.di BX
     141.\}
     142..
     143.de EM
     144.if t \{\
     145.br
     146.di
     147.ll
     148.gcolor
     149.nr BH \\n(dn
     150.ne \\n(BHu
     151\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
     152.in 0
     153.nf
     154.BX
     155.in
     156.fi
     157.\}
     158..
     159.\" -----------------------------------------------------------------
     160.\" * set default formatting
     161.\" -----------------------------------------------------------------
    9162.\" disable hyphenation
    10163.nh
    11164.\" disable justification (adjust text to left margin only)
    12165.ad l
    13 .SH "NAME"
    14 ldbedit - Edit LDB databases using your preferred editor
    15 .SH "SYNOPSIS"
    16 .HP 1
    17 ldbedit [\-?] [\-\-usage] [\-s\ base|one|sub] [\-b\ basedn] [\-a] [\-e\ editor] [\-H\ LDB\-URL] [expression] [attributes...]
     166.\" -----------------------------------------------------------------
     167.\" * MAIN CONTENT STARTS HERE *
     168.\" -----------------------------------------------------------------
     169.SH "Name"
     170ldbedit \- Edit LDB databases using your preferred editor
     171.SH "Synopsis"
     172.fam C
     173.HP \w'\ 'u
     174\FCldbedit\F[] [\-?] [\-\-usage] [\-s\ base|one|sub] [\-b\ basedn] [\-a] [\-e\ editor] [\-H\ LDB\-URL] [expression] [attributes...]
     175.fam
    18176.SH "DESCRIPTION"
    19177.PP
    20 ldbedit is a utility that allows you to edit LDB entries (in tdb files, sqlite files or LDAP servers) using your preferred editor\. ldbedit generates an LDIF file based on your query, allows you to edit the LDIF, and then merges that LDIF back into the LDB backend\.
     178ldbedit is a utility that allows you to edit LDB entries (in tdb files, sqlite files or LDAP servers) using your preferred editor\&. ldbedit generates an LDIF file based on your query, allows you to edit the LDIF, and then merges that LDIF back into the LDB backend\&.
    21179.SH "OPTIONS"
    22180.PP
    23181\-?, \-\-help
    24182.RS 4
    25 Show list of available options, and a phrase describing what that option does\.
     183Show list of available options, and a phrase describing what that option does\&.
    26184.RE
    27185.PP
    28186\-\-usage
    29187.RS 4
    30 Show list of available options\. This is similar to the help option, however it does not provide any description, and is hence shorter\.
     188Show list of available options\&. This is similar to the help option, however it does not provide any description, and is hence shorter\&.
    31189.RE
    32190.PP
    33191\-H <ldb\-url>
    34192.RS 4
    35 LDB URL to connect to\. For a tdb database, this will be of the form tdb://\fIfilename\fR\. For a LDAP connection over unix domain sockets, this will be of the form ldapi://\fIsocket\fR\. For a (potentially remote) LDAP connection over TCP, this will be of the form ldap://\fIhostname\fR\. For an SQLite database, this will be of the form sqlite://\fIfilename\fR\.
     193LDB URL to connect to\&. For a tdb database, this will be of the form tdb://\fIfilename\fR\&. For a LDAP connection over unix domain sockets, this will be of the form ldapi://\fIsocket\fR\&. For a (potentially remote) LDAP connection over TCP, this will be of the form ldap://\fIhostname\fR\&. For an SQLite database, this will be of the form sqlite://\fIfilename\fR\&.
    36194.RE
    37195.PP
    38196\-s one|sub|base
    39197.RS 4
    40 Search scope to use\. One\-level, subtree or base\.
     198Search scope to use\&. One\-level, subtree or base\&.
    41199.RE
    42200.PP
    43201\-a, \-all
    44202.RS 4
    45 Edit all records\. This allows you to apply the same change to a number of records at once\. You probably want to combine this with an expression of the form "objectclass=*"\.
     203Edit all records\&. This allows you to apply the same change to a number of records at once\&. You probably want to combine this with an expression of the form "objectclass=*"\&.
    46204.RE
    47205.PP
    48206\-e editor, \-\-editor editor
    49207.RS 4
    50 Specify the editor that should be used (overrides the VISUAL and EDITOR environment variables)\. If this option is not used, and neither VISUAL nor EDITOR environment variables are set, then the vi editor will be used\.
     208Specify the editor that should be used (overrides the VISUAL and EDITOR environment variables)\&. If this option is not used, and neither VISUAL nor EDITOR environment variables are set, then the vi editor will be used\&.
    51209.RE
    52210.PP
    53211\-b basedn
    54212.RS 4
    55 Specify Base Distinguished Name to use\.
     213Specify Base Distinguished Name to use\&.
    56214.RE
    57215.PP
    58216\-v, \-\-verbose
    59217.RS 4
    60 Make ldbedit more verbose about the operations that are being performed\. Without this option, ldbedit will only provide a summary change line\.
     218Make ldbedit more verbose about the operations that are being performed\&. Without this option, ldbedit will only provide a summary change line\&.
    61219.RE
    62220.SH "ENVIRONMENT"
     
    64222LDB_URL
    65223.RS 4
    66 LDB URL to connect to\. This can be overridden by using the \-H command\-line option\.)
     224LDB URL to connect to\&. This can be overridden by using the \-H command\-line option\&.)
    67225.RE
    68226.PP
    69227VISUAL and EDITOR
    70228.RS 4
    71 Environment variables used to determine what editor to use\. VISUAL takes precedence over EDITOR, and both are overridden by the \-e command\-line option\.
     229Environment variables used to determine what editor to use\&. VISUAL takes precedence over EDITOR, and both are overridden by the \-e command\-line option\&.
    72230.RE
    73231.SH "VERSION"
    74232.PP
    75 This man page is correct for version 4\.0 of the Samba suite\.
     233This man page is correct for version 4\&.0 of the Samba suite\&.
    76234.SH "SEE ALSO"
    77235.PP
     
    80238.PP
    81239ldb was written by
    82 Andrew Tridgell\.
     240Andrew Tridgell\&.
    83241.PP
    84242If you wish to report a problem or make a suggestion then please see the
    85243: http://ldb.samba.org/
    86 web site for current contact and maintainer information\.
    87 .PP
    88 This manpage was written by Jelmer Vernooij and updated by Brad Hards\.
     244web site for current contact and maintainer information\&.
     245.PP
     246This manpage was written by Jelmer Vernooij and updated by Brad Hards\&.
Note: See TracChangeset for help on using the changeset viewer.