First cut at a manual page for smbcacls.
authorTim Potter <tpot@samba.org>
Thu, 7 Dec 2000 06:22:03 +0000 (06:22 +0000)
committerTim Potter <tpot@samba.org>
Thu, 7 Dec 2000 06:22:03 +0000 (06:22 +0000)
(This used to be commit e5defa412874661f5012fa03cba2d854748884c2)

docs/htmldocs/smbcacls.1.html [new file with mode: 0644]
docs/manpages/smbcacls.1 [new file with mode: 0644]
docs/yodldocs/smbcacls.1.yo [new file with mode: 0644]

diff --git a/docs/htmldocs/smbcacls.1.html b/docs/htmldocs/smbcacls.1.html
new file mode 100644 (file)
index 0000000..a48330c
--- /dev/null
@@ -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>
diff --git a/docs/manpages/smbcacls.1 b/docs/manpages/smbcacls.1
new file mode 100644 (file)
index 0000000..69e9a92
--- /dev/null
@@ -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\&.
diff --git a/docs/yodldocs/smbcacls.1.yo b/docs/yodldocs/smbcacls.1.yo
new file mode 100644 (file)
index 0000000..d95ca6d
--- /dev/null
@@ -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.