Ignore:
Timestamp:
Jul 2, 2011, 3:35:33 PM (14 years ago)
Author:
Herwig Bauernfeind
Message:

Samba 3.5: Update trunk to 3.5.8

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/server/docs/manpages/pdbedit.8

    r480 r596  
     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: 06/18/2010
     4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
     5.\"      Date: 03/06/2011
    56.\"    Manual: System Administration tools
    67.\"    Source: Samba 3.5
    78.\"  Language: English
    89.\"
    9 .TH "PDBEDIT" "8" "06/18/2010" "Samba 3\&.5" "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" "03/06/2011" "Samba 3\&.5" "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[] [\-a] [\-b\ passdb\-backend] [\-c\ account\-control] [\-C\ value] [\-d\ debuglevel] [\-D\ drive] [\-e\ passdb\-backend] [\-f\ fullname] [\-\-force\-initialized\-passwords] [\-g] [\-h\ homedir] [\-i\ passdb\-backend] [\-I\ domain] [\-K] [\-L] [\-m] [\-M\ SID|RID] [\-N\ description] [\-P\ account\-policy] [\-p\ profile] [\-\-policies\-reset] [\-r] [\-s\ configfile] [\-S\ script] [\-t] [\-\-time\-format] [\-u\ username] [\-U\ SID|RID] [\-v] [\-V] [\-w] [\-x] [\-y] [\-z] [\-Z]
    175 .fam
     25pdbedit [\-a] [\-b\ passdb\-backend] [\-c\ account\-control] [\-C\ value] [\-d\ debuglevel] [\-D\ drive] [\-e\ passdb\-backend] [\-f\ fullname] [\-\-force\-initialized\-passwords] [\-g] [\-h\ homedir] [\-i\ passdb\-backend] [\-I\ domain] [\-K] [\-L] [\-m] [\-M\ SID|RID] [\-N\ description] [\-P\ account\-policy] [\-p\ profile] [\-\-policies\-reset] [\-r] [\-s\ configfile] [\-S\ script] [\-t] [\-\-time\-format] [\-u\ username] [\-U\ SID|RID] [\-v] [\-V] [\-w] [\-x] [\-y] [\-z] [\-Z]
    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\-M S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-1201\F[]
     174\-M 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[]
    375 .sp
    376 Example:
    377 \FC\'\-\-user SID\' S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004\F[]
    378 .sp
    379 Example:
    380 \FC\-U 5004\F[]
    381 .sp
    382 Example:
    383 \FC\'\-\-user SID\' 5004\F[]
     182\-U S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004
     183.sp
     184Example:
     185\'\-\-user SID\' S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004
     186.sp
     187Example:
     188\-U 5004
     189.sp
     190Example:
     191\'\-\-user SID\' 5004
    384192.RE
    385193.PP
     
    513321.sp
    514322Example:
    515 \FC\-c "[X ]"\F[]
     323\-c "[X ]"
    516324.RE
    517325.PP
     
    521329.sp
    522330Example:
    523 \FCpdbedit \-K never user\F[]
     331pdbedit \-K never user
    524332.RE
    525333.PP
     
    529337.sp
    530338Example:
    531 \FCpdbedit \-a \-u sorce\F[]
    532 .sp
    533 .if n \{\
    534 .RS 4
    535 .\}
    536 .fam C
    537 .ps -1
     339pdbedit \-a \-u sorce
     340.sp
     341.if n \{\
     342.RS 4
     343.\}
    538344.nf
    539 .BB lightgray
    540345new password:
    541346retype new password
    542 .EB lightgray
    543347.fi
    544 .fam
    545 .ps +1
    546 .if n \{\
    547 .RE
    548 .\}
    549 .sp
    550 .if n \{\
    551 .sp
    552 .\}
    553 .RS 4
    554 .BM yellow
     348.if n \{\
     349.RE
     350.\}
     351.sp
     352.if n \{\
     353.sp
     354.\}
     355.RS 4
    555356.it 1 an-trap
    556357.nr an-no-space-flag 1
     
    566367.sp
    567368If you wish to add a user and synchronise the password that immediately, use
    568 \FCsmbpasswd\F[]\'s
     369smbpasswd\'s
    569370\fB\-a\fR
    570371option\&.
    571372.sp .5v
    572 .EM yellow
    573373.RE
    574374.RE
     
    577377.RS 4
    578378This option causes pdbedit to read the password from standard input, rather than from /dev/tty (like the
    579 \FCpasswd(1)\F[]
     379passwd(1)
    580380program does)\&. The password has to be submitted twice and terminated by a newline each\&.
    581381.RE
     
    593393.sp
    594394Example:
    595 \FCpdbedit \-a \-m \-u w2k\-wks\F[]
     395pdbedit \-a \-m \-u w2k\-wks
    596396.RE
    597397.PP
     
    601401.sp
    602402Example:
    603 \FCpdbedit \-x \-u bob\F[]
     403pdbedit \-x \-u bob
    604404.RE
    605405.PP
     
    611411.sp
    612412Example:
    613 \FCpdbedit \-i smbpasswd:/etc/smbpasswd\&.old \F[]
     413pdbedit \-i smbpasswd:/etc/smbpasswd\&.old
    614414.RE
    615415.PP
     
    621421.sp
    622422Example:
    623 \FCpdbedit \-e smbpasswd:/root/samba\-users\&.backup\F[]
     423pdbedit \-e smbpasswd:/root/samba\-users\&.backup
    624424.RE
    625425.PP
     
    639439.sp
    640440Example:
    641 \FCpdbedit \-b xml:/root/pdb\-backup\&.xml \-l\F[]
     441pdbedit \-b xml:/root/pdb\-backup\&.xml \-l
    642442.RE
    643443.PP
     
    649449.sp
    650450Example:
    651 \FCpdbedit \-P "bad lockout attempt"\F[]
    652 .sp
    653 .if n \{\
    654 .RS 4
    655 .\}
    656 .fam C
    657 .ps -1
     451pdbedit \-P "bad lockout attempt"
     452.sp
     453.if n \{\
     454.RS 4
     455.\}
    658456.nf
    659 .if t \{\
    660 .sp -1
    661 .\}
    662 .BB lightgray adjust-for-leading-newline
    663 .sp -1
    664 
    665457account policy value for bad lockout attempt is 0
    666 .EB lightgray adjust-for-leading-newline
    667 .if t \{\
    668 .sp 1
    669 .\}
    670458.fi
    671 .fam
    672 .ps +1
    673459.if n \{\
    674460.RE
     
    683469.sp
    684470Example:
    685 \FCpdbedit \-P "bad lockout attempt" \-C 3\F[]
    686 .sp
    687 .if n \{\
    688 .RS 4
    689 .\}
    690 .fam C
    691 .ps -1
     471pdbedit \-P "bad lockout attempt" \-C 3
     472.sp
     473.if n \{\
     474.RS 4
     475.\}
    692476.nf
    693 .if t \{\
    694 .sp -1
    695 .\}
    696 .BB lightgray adjust-for-leading-newline
    697 .sp -1
    698 
    699477account policy value for bad lockout attempt was 0
    700478account policy value for bad lockout attempt is now 3
    701 .EB lightgray adjust-for-leading-newline
    702 .if t \{\
    703 .sp 1
    704 .\}
    705479.fi
    706 .fam
    707 .ps +1
    708480.if n \{\
    709481.RE
     
    721493.sp
    722494Example:
    723 \FCpdbedit \-y \-i tdbsam: \-e ldapsam:ldap://my\&.ldap\&.host\F[]
     495pdbedit \-y \-i tdbsam: \-e ldapsam:ldap://my\&.ldap\&.host
    724496.RE
    725497.PP
     
    734506.sp
    735507Example:
    736 \FC\-N "test description"\F[]
     508\-N "test description"
    737509.RE
    738510.PP
     
    742514.sp
    743515Example:
    744 \FC\-Z\F[]
     516\-Z
    745517.RE
    746518.PP
     
    750522.sp
    751523Example:
    752 \FC\-z\F[]
     524\-z
    753525.RE
    754526.PP
     
    758530.sp
    759531Example:
    760 \FC\-\-policies\-reset\F[]
     532\-\-policies\-reset
    761533.RE
    762534.PP
     
    766538.sp
    767539Example:
    768 \FC\-I "MYDOMAIN"\F[]
     540\-I "MYDOMAIN"
    769541.RE
    770542.PP
     
    791563\m[blue]\fB\%smb.conf.5.html#\fR\m[]
    792564parameter in the
    793 \FCsmb\&.conf\F[]
     565smb\&.conf
    794566file\&.
    795567.RE
     
    803575.RS 4
    804576The 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
    805 \FCsmb\&.conf\F[]
     577smb\&.conf
    806578for more information\&. The default configuration file name is determined at compile time\&.
    807579.RE
Note: See TracChangeset for help on using the changeset viewer.