~ubuntu-branches/ubuntu/lucid/samba/lucid-proposed

« back to all changes in this revision

Viewing changes to docs/htmldocs/smbcacls.1.html

  • Committer: Bazaar Package Importer
  • Author(s): Adam Conrad
  • Date: 2005-07-21 17:53:23 UTC
  • mfrom: (0.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050721175323-m3oh6aoigywohfnq
Tags: 3.0.14a-6ubuntu1
Resynchronise with Debian, resolving merge conflicts (#12360)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcacls</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.64.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbcacls.1"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>smbcacls &#8212; Set or get ACLs on an NT file or directory names</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">smbcacls</tt>  {//server/share} {filename} [-D acls] [-M acls] [-a acls] [-S acls] [-C name] [-G name] [--numeric] [-t] [-U username] [-h] [-d]</p></div></div><div class="refsect1" lang="en"><a name="id2478516"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <span><b class="command">smbcacls</b></span> program manipulates NT Access Control
2
 
        Lists (ACLs) on SMB file shares. </p></div><div class="refsect1" lang="en"><a name="id2478545"></a><h2>OPTIONS</h2><p>The following options are available to the <span><b class="command">smbcacls</b></span> program.  
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcacls</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbcacls.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcacls &#8212; Set or get ACLs on an NT file or directory names</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">smbcacls</tt>  {//server/share} {filename} [-D acls] [-M acls] [-a acls] [-S acls] [-C name] [-G name] [--numeric] [-t] [-U username] [-h] [-d]</p></div></div><div class="refsect1" lang="en"><a name="id2497623"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <span><b class="command">smbcacls</b></span> program manipulates NT Access Control
 
2
        Lists (ACLs) on SMB file shares. </p></div><div class="refsect1" lang="en"><a name="id2497652"></a><h2>OPTIONS</h2><p>The following options are available to the <span><b class="command">smbcacls</b></span> program.  
3
3
        The format of ACLs is described in the section ACL FORMAT </p><div class="variablelist"><dl><dt><span class="term">-a acls</span></dt><dd><p>Add the ACLs specified to the ACL list.  Existing 
4
4
                access control entries are unchanged. </p></dd><dt><span class="term">-M acls</span></dt><dd><p>Modify the mask value (permissions) for the ACLs 
5
5
                specified on the command line.  An error will be printed for each 
48
48
investigating a problem. Levels above 3 are designed for 
49
49
use only by developers and generate HUGE amounts of log
50
50
data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will 
51
 
override the <a class="indexterm" name="id2430271"></a>log level parameter
 
51
override the <a class="indexterm" name="id2449306"></a> parameter
52
52
in the <tt class="filename">smb.conf</tt> file.</p></dd><dt><span class="term">-l|--logfile=logdirectory</span></dt><dd><p>Base directory name for log/debug files. The extension
53
53
<tt class="constant">".progname"</tt> will be appended (e.g. log.smbclient, 
54
54
log.smbd, etc...). The log file is never removed by the client.
55
 
</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2429141"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by 
 
55
</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2448273"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by 
56
56
        either commas or newlines.  An ACL entry is one of the following: </p><pre class="programlisting"> 
57
57
REVISION:&lt;revision number&gt;
58
58
OWNER:&lt;sid or name&gt;
78
78
        file permissions of the same name. </p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>R</em></span> - Allow read access </p></li><li><p><span class="emphasis"><em>W</em></span> - Allow write access</p></li><li><p><span class="emphasis"><em>X</em></span> - Execute permission on the object</p></li><li><p><span class="emphasis"><em>D</em></span> - Delete the object</p></li><li><p><span class="emphasis"><em>P</em></span> - Change permissions</p></li><li><p><span class="emphasis"><em>O</em></span> - Take ownership</p></li></ul></div><p>The following combined permissions can be specified:</p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>READ</em></span> -  Equivalent to 'RX'
79
79
                permissions</p></li><li><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
80
80
                </p></li><li><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO' 
81
 
                permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2429305"></a><h2>EXIT STATUS</h2><p>The <span><b class="command">smbcacls</b></span> program sets the exit status 
 
81
                permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2448438"></a><h2>EXIT STATUS</h2><p>The <span><b class="command">smbcacls</b></span> program sets the exit status 
82
82
        depending on the success or otherwise of the operations performed.  
83
83
        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcacls returns and exit 
84
84
        status of 0.  If <span><b class="command">smbcacls</b></span> couldn't connect to the specified server, 
85
85
        or there was an error getting or setting the ACLs, an exit status 
86
86
        of 1 is returned.  If there was an error parsing any command line 
87
 
        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2429338"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2429349"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities 
 
87
        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2448470"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2448481"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities 
88
88
        were created by Andrew Tridgell. Samba is now developed
89
89
        by the Samba Team as an Open Source project similar 
90
90
        to the way the Linux kernel is developed.</p><p><span><b class="command">smbcacls</b></span> was written by Andrew Tridgell