Ignore:
Timestamp:
Jan 15, 2010, 8:21:06 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3 to 3.3.10 (docs)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.3.x/docs/manpages/pdbedit.8

    r342 r368  
     1'\" t
    12.\"     Title: pdbedit
    23.\"    Author: [see the "AUTHOR" section]
    3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
    4 .\"      Date: 10/12/2009
     4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
     5.\"      Date: 01/14/2010
    56.\"    Manual: System Administration tools
    67.\"    Source: Samba 3.3
    78.\"  Language: English
    89.\"
    9 .TH "PDBEDIT" "8" "10/12/2009" "Samba 3\&.3" "System Administration tools"
    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 ..
     10.TH "PDBEDIT" "8" "01/14/2010" "Samba 3\&.3" "System Administration tools"
    15911.\" -----------------------------------------------------------------
    16012.\" * set default formatting
     
    16719.\" * MAIN CONTENT STARTS HERE *
    16820.\" -----------------------------------------------------------------
    169 .SH "Name"
     21.SH "NAME"
    17022pdbedit \- manage the SAM database (Database of Samba Users)
    171 .SH "Synopsis"
    172 .fam C
     23.SH "SYNOPSIS"
    17324.HP \w'\ 'u
    174 \FCpdbedit\F[] [\-L] [\-v] [\-w] [\-u\ username] [\-f\ fullname] [\-h\ homedir] [\-D\ drive] [\-S\ script] [\-p\ profile] [\-a] [\-t,\ \-\-password\-from\-stdin] [\-m] [\-r] [\-x] [\-i\ passdb\-backend] [\-e\ passdb\-backend] [\-b\ passdb\-backend] [\-g] [\-d\ debuglevel] [\-s\ configfile] [\-P\ account\-policy] [\-C\ value] [\-c\ account\-control] [\-y]
    175 .fam
     25pdbedit [\-L] [\-v] [\-w] [\-u\ username] [\-f\ fullname] [\-h\ homedir] [\-D\ drive] [\-S\ script] [\-p\ profile] [\-a] [\-t,\ \-\-password\-from\-stdin] [\-m] [\-r] [\-x] [\-i\ passdb\-backend] [\-e\ passdb\-backend] [\-b\ passdb\-backend] [\-g] [\-d\ debuglevel] [\-s\ configfile] [\-P\ account\-policy] [\-C\ value] [\-c\ account\-control] [\-y]
    17626.SH "DESCRIPTION"
    17727.PP
     
    19242.sp
    19343Example:
    194 \FCpdbedit \-L\F[]
    195 .sp
    196 .if n \{\
    197 .RS 4
    198 .\}
    199 .fam C
    200 .ps -1
     44pdbedit \-L
     45.sp
     46.if n \{\
     47.RS 4
     48.\}
    20149.nf
    202 .if t \{\
    203 .sp -1
    204 .\}
    205 .BB lightgray adjust-for-leading-newline
    206 .sp -1
    207 
    20850sorce:500:Simo Sorce
    20951samba:45:Test User
    210 .EB lightgray adjust-for-leading-newline
    211 .if t \{\
    212 .sp 1
    213 .\}
    21452.fi
    215 .fam
    216 .ps +1
    21753.if n \{\
    21854.RE
     
    22561.sp
    22662Example:
    227 \FCpdbedit \-L \-v\F[]
    228 .sp
    229 .if n \{\
    230 .RS 4
    231 .\}
    232 .fam C
    233 .ps -1
     63pdbedit \-L \-v
     64.sp
     65.if n \{\
     66.RS 4
     67.\}
    23468.nf
    235 .if t \{\
    236 .sp -1
    237 .\}
    238 .BB lightgray adjust-for-leading-newline
    239 .sp -1
    240 
    24169\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
    24270username:       sorce
     
    25785Logon Script:   
    25886Profile Path:   \e\eBERSERKER\eprofile
    259 .EB lightgray adjust-for-leading-newline
    260 .if t \{\
    261 .sp 1
    262 .\}
    26387.fi
    264 .fam
    265 .ps +1
    26688.if n \{\
    26789.RE
     
    27294.RS 4
    27395This option sets the "smbpasswd" listing format\&. It will make pdbedit list the users in the database, printing out the account fields in a format compatible with the
    274 \FCsmbpasswd\F[]
     96smbpasswd
    27597file format\&. (see the
    27698\fBsmbpasswd\fR(5)
     
    278100.sp
    279101Example:
    280 \FCpdbedit \-L \-w\F[]
    281 .sp
    282 .if n \{\
    283 .RS 4
    284 .\}
    285 .fam C
    286 .ps -1
     102pdbedit \-L \-w
     103.sp
     104.if n \{\
     105.RS 4
     106.\}
    287107.nf
    288 .if t \{\
    289 .sp -1
    290 .\}
    291 .BB lightgray adjust-for-leading-newline
    292 .sp -1
    293 
    294108sorce:500:508818B733CE64BEAAD3B435B51404EE:
    295109          D2A2418EFC466A8A0F6B1DBB5C3DB80C:
     
    298112          BC281CE3F53B6A5146629CD4751D3490:
    299113          [UX         ]:LCT\-3BFA1E8D:
    300 .EB lightgray adjust-for-leading-newline
    301 .if t \{\
    302 .sp 1
    303 .\}
    304114.fi
    305 .fam
    306 .ps +1
    307115.if n \{\
    308116.RE
     
    324132.sp
    325133Example:
    326 \FC\-f "Simo Sorce"\F[]
     134\-f "Simo Sorce"
    327135.RE
    328136.PP
     
    332140.sp
    333141Example:
    334 \FC\-h "\e\e\e\eBERSERKER\e\esorce"\F[]
     142\-h "\e\e\e\eBERSERKER\e\esorce"
    335143.RE
    336144.PP
     
    340148.sp
    341149Example:
    342 \FC\-D "H:"\F[]
     150\-D "H:"
    343151.RE
    344152.PP
     
    348156.sp
    349157Example:
    350 \FC\-S "\e\e\e\eBERSERKER\e\enetlogon\e\esorce\&.bat"\F[]
     158\-S "\e\e\e\eBERSERKER\e\enetlogon\e\esorce\&.bat"
    351159.RE
    352160.PP
     
    356164.sp
    357165Example:
    358 \FC\-p "\e\e\e\eBERSERKER\e\enetlogon"\F[]
     166\-p "\e\e\e\eBERSERKER\e\enetlogon"
    359167.RE
    360168.PP
     
    364172.sp
    365173Example:
    366 \FC\-G S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-1201\F[]
     174\-G S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-1201
    367175.RE
    368176.PP
     
    372180.sp
    373181Example:
    374 \FC\-U S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004\F[]
     182\-U S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004
    375183.RE
    376184.PP
     
    504312.sp
    505313Example:
    506 \FC\-c "[X ]"\F[]
     314\-c "[X ]"
    507315.RE
    508316.PP
     
    512320.sp
    513321Example:
    514 \FCpdbedit \-a \-u sorce\F[]
    515 .sp
    516 .if n \{\
    517 .RS 4
    518 .\}
    519 .fam C
    520 .ps -1
     322pdbedit \-a \-u sorce
     323.sp
     324.if n \{\
     325.RS 4
     326.\}
    521327.nf
    522 .BB lightgray
    523328new password:
    524329retype new password
    525 .EB lightgray
    526330.fi
    527 .fam
    528 .ps +1
    529 .if n \{\
    530 .RE
    531 .\}
    532 .sp
    533 .if n \{\
    534 .sp
    535 .\}
    536 .RS 4
    537 .BM yellow
     331.if n \{\
     332.RE
     333.\}
     334.sp
     335.if n \{\
     336.sp
     337.\}
     338.RS 4
    538339.it 1 an-trap
    539340.nr an-no-space-flag 1
     
    549350.sp
    550351If you wish to add a user and synchronise the password that immediately, use
    551 \FCsmbpasswd\F[]\'s
     352smbpasswd\'s
    552353\fB\-a\fR
    553354option\&.
    554355.sp .5v
    555 .EM yellow
    556356.RE
    557357.RE
     
    560360.RS 4
    561361This option causes pdbedit to read the password from standard input, rather than from /dev/tty (like the
    562 \FCpasswd(1)\F[]
     362passwd(1)
    563363program does)\&. The password has to be submitted twice and terminated by a newline each\&.
    564364.RE
     
    576376.sp
    577377Example:
    578 \FCpdbedit \-a \-m \-u w2k\-wks\F[]
     378pdbedit \-a \-m \-u w2k\-wks
    579379.RE
    580380.PP
     
    584384.sp
    585385Example:
    586 \FCpdbedit \-x \-u bob\F[]
     386pdbedit \-x \-u bob
    587387.RE
    588388.PP
     
    594394.sp
    595395Example:
    596 \FCpdbedit \-i smbpasswd:/etc/smbpasswd\&.old \F[]
     396pdbedit \-i smbpasswd:/etc/smbpasswd\&.old
    597397.RE
    598398.PP
     
    604404.sp
    605405Example:
    606 \FCpdbedit \-e smbpasswd:/root/samba\-users\&.backup\F[]
     406pdbedit \-e smbpasswd:/root/samba\-users\&.backup
    607407.RE
    608408.PP
     
    622422.sp
    623423Example:
    624 \FCpdbedit \-b xml:/root/pdb\-backup\&.xml \-l\F[]
     424pdbedit \-b xml:/root/pdb\-backup\&.xml \-l
    625425.RE
    626426.PP
     
    632432.sp
    633433Example:
    634 \FCpdbedit \-P "bad lockout attempt"\F[]
    635 .sp
    636 .if n \{\
    637 .RS 4
    638 .\}
    639 .fam C
    640 .ps -1
     434pdbedit \-P "bad lockout attempt"
     435.sp
     436.if n \{\
     437.RS 4
     438.\}
    641439.nf
    642 .if t \{\
    643 .sp -1
    644 .\}
    645 .BB lightgray adjust-for-leading-newline
    646 .sp -1
    647 
    648440account policy value for bad lockout attempt is 0
    649 .EB lightgray adjust-for-leading-newline
    650 .if t \{\
    651 .sp 1
    652 .\}
    653441.fi
    654 .fam
    655 .ps +1
    656442.if n \{\
    657443.RE
     
    666452.sp
    667453Example:
    668 \FCpdbedit \-P "bad lockout attempt" \-C 3\F[]
    669 .sp
    670 .if n \{\
    671 .RS 4
    672 .\}
    673 .fam C
    674 .ps -1
     454pdbedit \-P "bad lockout attempt" \-C 3
     455.sp
     456.if n \{\
     457.RS 4
     458.\}
    675459.nf
    676 .if t \{\
    677 .sp -1
    678 .\}
    679 .BB lightgray adjust-for-leading-newline
    680 .sp -1
    681 
    682460account policy value for bad lockout attempt was 0
    683461account policy value for bad lockout attempt is now 3
    684 .EB lightgray adjust-for-leading-newline
    685 .if t \{\
    686 .sp 1
    687 .\}
    688462.fi
    689 .fam
    690 .ps +1
    691463.if n \{\
    692464.RE
     
    704476.sp
    705477Example:
    706 \FCpdbedit \-y \-i tdbsam: \-e ldapsam:ldap://my\&.ldap\&.host\F[]
     478pdbedit \-y \-i tdbsam: \-e ldapsam:ldap://my\&.ldap\&.host
    707479.RE
    708480.PP
     
    722494.sp
    723495Note that specifying this parameter here will override the
    724 \m[blue]\fBlog level\fR\m[]
     496\m[blue]\fB\%smb.conf.5.html#\fR\m[]
    725497parameter in the
    726 \FCsmb\&.conf\F[]
     498smb\&.conf
    727499file\&.
    728500.RE
    729501.PP
    730 \-V
     502\-V|\-\-version
    731503.RS 4
    732504Prints the program version number\&.
    733505.RE
    734506.PP
    735 \-s <configuration file>
     507\-s|\-\-configfile <configuration file>
    736508.RS 4
    737509The file specified contains the configuration details required by the server\&. The information in this file includes server\-specific information such as what printcap file to use, as well as descriptions of all the services that the server is to provide\&. See
    738 \FCsmb\&.conf\F[]
     510smb\&.conf
    739511for more information\&. The default configuration file name is determined at compile time\&.
    740512.RE
Note: See TracChangeset for help on using the changeset viewer.