source: branches/samba-3.3.x/docs/manpages/pdbedit.8@ 368

Last change on this file since 368 was 368, checked in by Herwig Bauernfeind, 16 years ago

Update Samba 3.3 to 3.3.10 (docs)

File size: 12.8 KB
Line 
1'\" t
2.\" Title: pdbedit
3.\" Author: [see the "AUTHOR" section]
4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5.\" Date: 01/14/2010
6.\" Manual: System Administration tools
7.\" Source: Samba 3.3
8.\" Language: English
9.\"
10.TH "PDBEDIT" "8" "01/14/2010" "Samba 3\&.3" "System Administration tools"
11.\" -----------------------------------------------------------------
12.\" * set default formatting
13.\" -----------------------------------------------------------------
14.\" disable hyphenation
15.nh
16.\" disable justification (adjust text to left margin only)
17.ad l
18.\" -----------------------------------------------------------------
19.\" * MAIN CONTENT STARTS HERE *
20.\" -----------------------------------------------------------------
21.SH "NAME"
22pdbedit \- manage the SAM database (Database of Samba Users)
23.SH "SYNOPSIS"
24.HP \w'\ 'u
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]
26.SH "DESCRIPTION"
27.PP
28This tool is part of the
29\fBsamba\fR(7)
30suite\&.
31.PP
32The pdbedit program is used to manage the users accounts stored in the sam database and can only be run by root\&.
33.PP
34The pdbedit tool uses the passdb modular interface and is independent from the kind of users database used (currently there are smbpasswd, ldap, nis+ and tdb based and more can be added without changing the tool)\&.
35.PP
36There are five main ways to use pdbedit: adding a user account, removing a user account, modifing a user account, listing user accounts, importing users accounts\&.
37.SH "OPTIONS"
38.PP
39\-L
40.RS 4
41This option lists all the user accounts present in the users database\&. This option prints a list of user/uid pairs separated by the \':\' character\&.
42.sp
43Example:
44pdbedit \-L
45.sp
46.if n \{\
47.RS 4
48.\}
49.nf
50sorce:500:Simo Sorce
51samba:45:Test User
52.fi
53.if n \{\
54.RE
55.\}
56.RE
57.PP
58\-v
59.RS 4
60This option enables the verbose listing format\&. It causes pdbedit to list the users in the database, printing out the account fields in a descriptive format\&.
61.sp
62Example:
63pdbedit \-L \-v
64.sp
65.if n \{\
66.RS 4
67.\}
68.nf
69\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
70username: sorce
71user ID/Group: 500/500
72user RID/GRID: 2000/2001
73Full Name: Simo Sorce
74Home Directory: \e\eBERSERKER\esorce
75HomeDir Drive: H:
76Logon Script: \e\eBERSERKER\enetlogon\esorce\&.bat
77Profile Path: \e\eBERSERKER\eprofile
78\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
79username: samba
80user ID/Group: 45/45
81user RID/GRID: 1090/1091
82Full Name: Test User
83Home Directory: \e\eBERSERKER\esamba
84HomeDir Drive: