1
0
mirror of https://github.com/samba-team/samba.git synced 2025-03-05 20:58:40 +03:00

First cut at a manual page for smbcacls.

(This used to be commit e5defa412874661f5012fa03cba2d854748884c2)
This commit is contained in:
Tim Potter 2000-12-07 06:22:03 +00:00
parent 028b197845
commit 607c384aa5
3 changed files with 238 additions and 0 deletions

View File

@ -0,0 +1,82 @@
<html><head><title>smbcacls (1)</title>
</head>
<body>
<hr>
<h1>smbcacls (1)</h1>
<h2>Samba</h2>
<h2>3 Dec 2000</h2>
<p><a name="NAME"></a>
<h2>NAME</h2>
smbcacls - Set or get ACLs on an NT file
<p><a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<p><strong>smbcacls</strong> //server/share filename <a href="smbcacls.1.html#minusU">-U username</a>
[<a href="smbcacls.1.html#minusA">-A acls</a>] [<a href="smbcacls.1.html#minusM">-M acls</a>]
[<a href="smbcacls.1.html#minusD">-D acls</a>] [<a href="smbcacls.1.html#minusS">-S acls</a>]
[<a href="smbcacls.1.html#minusn">-n</a>] [<a href="smbcacls.1.html#minush">-h</a>]
<p><a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<p>The <strong>smbcacls</strong> program manipulates NT Access Control Lists (ACLs) on
SMB file shares.
<p><a name="OPTIONS"></a>
<h2>OPTIONS</h2>
<p>The following options are available to the <strong>smbcacls</strong> program:
<p><dl>
<p><a name="minusA"></a>
<p></p><dt><strong><strong>-A acls</strong></strong><dd>
<p>Add the ACLs specified to the ACL list.
<p><a name="minusM"></a>
<p></p><dt><strong><strong>-M acls</strong></strong><dd>
<p>Modify the mask value (permissions) for the ACLs specified on the command
line. An error will be printed if the ACL specified is not already present
in the ACL list
<p><a name="minusD"></a>
<p></p><dt><strong><strong>-D acls</strong></strong><dd>
<p>Delete any ACLs specfied on the command line. An error is printed if any
of the ACLs specified are not present in the ACL list.
<p><a name="minusS"></a>
<p></p><dt><strong><strong>-S acls</strong></strong><dd>
<p>This command deletes the current ACLs for the file or directory and
replaces them with the ACLs specified on the command line.
<p><a name="minusU"></a>
<p></p><dt><strong><strong>-U username</strong></strong><dd>
<p>Specifies a username used to connect to the specified service. The
username may be of the form <code>username</code> in which case the user is
prompted to enter in a password and the workgroup specified in the
<a href="smb.conf.5.html"><strong>smb.conf</strong></a> file is used, or <code>username%password</code>
or <code>DOMAIN\username%password</code> and the password and workgroup names are
used as provided.
<p><a name="minusn"></a>
<p></p><dt><strong><strong>-n</strong></strong><dd>
<p>This option displays all ACL information in numeric format. The default is
to convert SIDs to names and ACE types and masks to a readable string
format.
<p><a name="minush"></a>
<p></p><dt><strong><strong>-h</strong></strong><dd>
<p>Print usage information on the <strong>smbcacls</strong> program
<p></dl>
<p><a name="EXITSTATUS"></a>
<h2>EXIT STATUS</h2>
<p><a name="AUTHOR"></a>
<h2>AUTHOR</h2>
<p>The original Samba software and related utilities were created by
Andrew Tridgell. Samba is now developed by the Samba Team as an Open
Source project.
<p><strong>smbcacls</strong> was written by Andrew Tridgell and Tim Potter.
</body>
</html>

71
docs/manpages/smbcacls.1 Normal file
View File

@ -0,0 +1,71 @@
.TH "smbcacls " "1" "3 Dec 2000" "Samba" "SAMBA"
.PP
.SH "NAME"
smbcacls \- Set or get ACLs on an NT file
.PP
.SH "SYNOPSIS"
.PP
\fBsmbcacls\fP //server/share filename -U username
[-A acls] [-M acls]
[-D acls] [-S acls]
[-n] [-h]
.PP
.SH "DESCRIPTION"
.PP
The \fBsmbcacls\fP program manipulates NT Access Control Lists (ACLs) on
SMB file shares\&.
.PP
.SH "OPTIONS"
.PP
The following options are available to the \fBsmbcacls\fP program:
.PP
.IP
.IP "\fB-A acls\fP"
.IP
Add the ACLs specified to the ACL list\&.
.IP
.IP "\fB-M acls\fP"
.IP
Modify the mask value (permissions) for the ACLs specified on the command
line\&. An error will be printed if the ACL specified is not already present
in the ACL list
.IP
.IP "\fB-D acls\fP"
.IP
Delete any ACLs specfied on the command line\&. An error is printed if any
of the ACLs specified are not present in the ACL list\&.
.IP
.IP "\fB-S acls\fP"
.IP
This command deletes the current ACLs for the file or directory and
replaces them with the ACLs specified on the command line\&.
.IP
.IP "\fB-U username\fP"
.IP
Specifies a username used to connect to the specified service\&. The
username may be of the form \f(CWusername\fP in which case the user is
prompted to enter in a password and the workgroup specified in the
\fBsmb\&.conf\fP file is used, or \f(CWusername%password\fP
or \f(CWDOMAIN\eusername%password\fP and the password and workgroup names are
used as provided\&.
.IP
.IP "\fB-n\fP"
.IP
This option displays all ACL information in numeric format\&. The default is
to convert SIDs to names and ACE types and masks to a readable string
format\&.
.IP
.IP "\fB-h\fP"
.IP
Print usage information on the \fBsmbcacls\fP program
.IP
.PP
.SH "EXIT STATUS"
.PP
.SH "AUTHOR"
.PP
The original Samba software and related utilities were created by
Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open
Source project\&.
.PP
\fBsmbcacls\fP was written by Andrew Tridgell and Tim Potter\&.

View File

@ -0,0 +1,85 @@
manpage(smbcacls htmlcommand((1)))(1)(3 Dec 2000)(Samba)(SAMBA)
label(NAME)
manpagename(smbcacls)(Set or get ACLs on an NT file)
label(SYNOPSIS)
manpagesynopsis()
bf(smbcacls) //server/share filename link(-U username)(minusU)
[link(-A acls)(minusA)] [link(-M acls)(minusM)]
[link(-D acls)(minusD)] [link(-S acls)(minusS)]
[link(-n)(minusn)] [link(-h)(minush)]
label(DESCRIPTION)
manpagedescription()
The bf(smbcacls) program manipulates NT Access Control Lists (ACLs) on
SMB file shares.
label(OPTIONS)
manpageoptions()
The following options are available to the bf(smbcacls) program:
startdit()
label(minusA)
dit(bf(-A acls))
Add the ACLs specified to the ACL list.
label(minusM)
dit(bf(-M acls))
Modify the mask value (permissions) for the ACLs specified on the command
line. An error will be printed if the ACL specified is not already present
in the ACL list
label(minusD)
dit(bf(-D acls))
Delete any ACLs specfied on the command line. An error is printed if any
of the ACLs specified are not present in the ACL list.
label(minusS)
dit(bf(-S acls))
This command deletes the current ACLs for the file or directory and
replaces them with the ACLs specified on the command line.
label(minusU)
dit(bf(-U username))
Specifies a username used to connect to the specified service. The
username may be of the form tt(username) in which case the user is
prompted to enter in a password and the workgroup specified in the
url(bf(smb.conf))(smb.conf.5.html) file is used, or tt(username%password)
or tt(DOMAIN\username%password) and the password and workgroup names are
used as provided.
label(minusn)
dit(bf(-n))
This option displays all ACL information in numeric format. The default is
to convert SIDs to names and ACE types and masks to a readable string
format.
label(minush)
dit(bf(-h))
Print usage information on the bf(smbcacls) program
enddit()
label(EXIT STATUS)
manpagesection(EXIT STATUS)
label(AUTHOR)
manpageauthor()
The original Samba software and related utilities were created by
Andrew Tridgell. Samba is now developed by the Samba Team as an Open
Source project.
bf(smbcacls) was written by Andrew Tridgell and Tim Potter.