diff options
Diffstat (limited to 'docs/htmldocs')
| -rw-r--r-- | docs/htmldocs/smbcacls.1.html | 378 | ||||
| -rw-r--r-- | docs/htmldocs/smbmnt.8.html | 156 | ||||
| -rw-r--r-- | docs/htmldocs/smbmount.8.html | 264 | ||||
| -rw-r--r-- | docs/htmldocs/smbumount.8.html | 130 |
4 files changed, 928 insertions, 0 deletions
diff --git a/docs/htmldocs/smbcacls.1.html b/docs/htmldocs/smbcacls.1.html new file mode 100644 index 00000000000..36f570f2a0a --- /dev/null +++ b/docs/htmldocs/smbcacls.1.html @@ -0,0 +1,378 @@ +<HTML +><HEAD +><TITLE +>smbcacls</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD +><BODY +CLASS="REFENTRY" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><H1 +><A +NAME="SMBCACLS" +>smbcacls</A +></H1 +><DIV +CLASS="REFNAMEDIV" +><A +NAME="AEN5" +></A +><H2 +>Name</H2 +>smbcacls -- Set or get ACLs on an NT file or directory names</DIV +><DIV +CLASS="REFSYNOPSISDIV" +><A +NAME="AEN8" +></A +><H2 +>Synopsis</H2 +><P +><B +CLASS="COMMAND" +>nmblookup</B +> {//server/share} {filename} [-U username] [-A acls] [-M acls] [-D acls] [-S acls] [-C name] [-G name] [-n] [-h]</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN22" +></A +><H2 +>DESCRIPTION</H2 +><P +>This tool is part of the <A +HREF="samba.7.html" +TARGET="_top" +> Samba</A +> suite.</P +><P +>The smbcacls program manipulates NT Access Control Lists + (ACLs) on SMB file shares. </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN27" +></A +><H2 +>OPTIONS</H2 +><P +>The following options are available to the smbcacls program. + The format of ACLs is described in the section ACL FORMAT </P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>-A acls</DT +><DD +><P +>Add the ACLs specified to the ACL list. Existing + access control entries are unchanged. </P +></DD +><DT +>-M acls</DT +><DD +><P +>Modify the mask value (permissions) for the ACLs + specified on the command line. An error will be printed for each + ACL specified that was not already present in the ACL list + </P +></DD +><DT +>-D acls</DT +><DD +><P +>Delete any ACLs specfied on the command line. + An error will be printed for each ACL specified that was not + already present in the ACL list. </P +></DD +><DT +>-S acls</DT +><DD +><P +>This command sets the ACLs on the file with + only the ones specified on the command line. All other ACLs are + erased. Note that the ACL specified must contain at least a revision, + type, owner and group for the call to succeed. </P +></DD +><DT +>-U username</DT +><DD +><P +>Specifies a username used to connect to the + specified service. The username may be of the form "username" in + which case the user is prompted to enter in a password and the + workgroup specified in the <TT +CLASS="FILENAME" +>smb.conf</TT +> file is + used, or "username%password" or "DOMAIN\username%password" and the + password and workgroup names are used as provided. </P +></DD +><DT +>-C name</DT +><DD +><P +>The owner of a file or directory can be changed + to the name given using the <TT +CLASS="PARAMETER" +><I +>-C</I +></TT +> option. + The name can be a sid in the form S-1-x-y-z or a name resolved + against the server specified in the first argument. </P +><P +>This command is a shortcut for -M OWNER:name. + </P +></DD +><DT +>-G name</DT +><DD +><P +>The group owner of a file or directory can + be changed to the name given using the <TT +CLASS="PARAMETER" +><I +>-G</I +></TT +> + option. The name can be a sid in the form S-1-x-y-z or a name + resolved against the server specified n the first argument. + </P +><P +>This command is a shortcut for -M GROUP:name.</P +></DD +><DT +>-n</DT +><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 +></DD +><DT +>-h</DT +><DD +><P +>Print usage information on the <B +CLASS="COMMAND" +>smbcacls + </B +> program.</P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN73" +></A +><H2 +>ACL FORMAT</H2 +><P +>The format of an ACL is one or more ACL entries separated by + either commas or newlines. An ACL entry is one of the following: </P +><P +><PRE +CLASS="PROGRAMLISTING" +> +REVISION:<revision number> +OWNER:<sid or name> +GROUP:<sid or name> +ACL:<sid or name>:<type>/<flags>/<mask> + </PRE +></P +><P +>The revision of the ACL specifies the internal Windows + NT ACL revision for the security descriptor. + If not specified it defaults to 1. Using values other than 1 may + cause strange behaviour. </P +><P +>The owner and group specify the owner and group sids for the + object. If a SID in the format CWS-1-x-y-z is specified this is used, + otherwise the name specified is resolved using the server on which + the file or directory resides. </P +><P +>ACLs specify permissions granted to the SID. This SID again + can be specified in CWS-1-x-y-z format or as a name in which case + it is resolved against the server on which the file or directory + resides. The type, flags and mask values determine the type of + access granted to the SID. </P +><P +>The type can be either 0 or 1 corresponding to ALLOWED or + DENIED access to the SID. The flags values are generally + zero for file ACLs and either 9 or 2 for directory ACLs. Some + common flags are: </P +><P +></P +><UL +><LI +><P +>#define SEC_ACE_FLAG_OBJECT_INHERIT 0x1</P +></LI +><LI +><P +>#define SEC_ACE_FLAG_CONTAINER_INHERIT 0x2</P +></LI +><LI +><P +>#define SEC_ACE_FLAG_NO_PROPAGATE_INHERIT 0x4 + </P +></LI +><LI +><P +>#define SEC_ACE_FLAG_INHERIT_ONLY 0x8</P +></LI +></UL +><P +>At present flags can only be specified as decimal or + hexadecimal values.</P +><P +>The mask is a value which expresses the access right + granted to the SID. It can be given as a decimal or hexadecimal value, + or by using one of the following text strings which map to the NT + file permissions of the same name. </P +><P +></P +><UL +><LI +><P +><I +CLASS="EMPHASIS" +>R</I +> - Allow read access </P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>W</I +> - Allow write access</P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>X</I +> - Execute permission on the object</P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>D</I +> - Delete the object</P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>P</I +> - Change permissions</P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>O</I +> - Take ownership</P +></LI +></UL +><P +>The following combined permissions can be specified:</P +><P +></P +><UL +><LI +><P +><I +CLASS="EMPHASIS" +>READ</I +> - Equivalent to 'RX' + permissions</P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>CHANGE</I +> - Equivalent to 'RXWD' permissions + </P +></LI +><LI +><P +><I +CLASS="EMPHASIS" +>FULL</I +> - Equivalent to 'RWXDPO' + permissions</P +></LI +></UL +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN123" +></A +><H2 +>EXIT STATUS</H2 +><P +>The <B +CLASS="COMMAND" +>smbcacls</B +> program sets the exit status + depending on the success or otherwise of the operations performed. + The exit status may be one of the following values. </P +><P +>If the operation succeded, smbcacls returns and exit + status of 0. If smbcacls couldn't connect to the specified server, + or there was an error getting or setting the ACLs, an exit status + of 1 is returned. If there was an error parsing any command line + arguments, an exit status of 2 is returned. </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN128" +></A +><H2 +>VERSION</H2 +><P +>This man page is correct for version 2.2 of + the Samba suite.</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN131" +></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 similar + to the way the Linux kernel is developed.</P +><P +><B +CLASS="COMMAND" +>smbcacls</B +> was written by Andrew Tridgell + and Tim Potter.</P +><P +>The conversion to DocBook for Samba 2.2 was done + by Gerald Carter</P +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/docs/htmldocs/smbmnt.8.html b/docs/htmldocs/smbmnt.8.html new file mode 100644 index 00000000000..051684a291b --- /dev/null +++ b/docs/htmldocs/smbmnt.8.html @@ -0,0 +1,156 @@ +<HTML +><HEAD +><TITLE +>smbmnt</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD +><BODY +CLASS="REFENTRY" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><H1 +><A +NAME="SMBUMOUNT" +>smbmnt</A +></H1 +><DIV +CLASS="REFNAMEDIV" +><A +NAME="AEN5" +></A +><H2 +>Name</H2 +>smbmnt -- helper utility for mounting SMB filesystems</DIV +><DIV +CLASS="REFSYNOPSISDIV" +><A +NAME="AEN8" +></A +><H2 +>Synopsis</H2 +><P +><B +CLASS="COMMAND" +>smbumount</B +> {mount-point} [-s <share>] [-r] [-u <uid>] [-g <gid>] [-f <mask>] [-d <mask>]</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN18" +></A +><H2 +>DESCRIPTION</H2 +><P +><B +CLASS="COMMAND" +>smbmnt</B +> is a helper application used + by the smbmount program to do the actual mounting of SMB shares. + <B +CLASS="COMMAND" +>smbmnt</B +> is meant to be installed setuid root + so that normal users can mount their smb shares. It checks + whether the user has write permissions on the mount point and + then mounts the directory.</P +><P +>The <B +CLASS="COMMAND" +>smbmnt</B +> program is normally invoked + by <A +HREF="smbmount.8.html" +TARGET="_top" +><B +CLASS="COMMAND" +>smbmount(8)</B +> + </A +>. It should not be invoked directly by users. </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN27" +></A +><H2 +>OPTIONS</H2 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>-r</DT +><DD +><P +>mount the filesystem read-only + </P +></DD +><DT +>-u uid</DT +><DD +><P +>specify the uid that the files will + be owned by </P +></DD +><DT +>-g gid</DT +><DD +><P +>specify the gid that the files will be + owned by </P +></DD +><DT +>-f mask</DT +><DD +><P +>specify the octal file mask applied + </P +></DD +><DT +>-d mask</DT +><DD +><P +>specify the octal directory mask + applied </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN50" +></A +><H2 +>AUTHOR</H2 +><P +>The current maintainer of smbfs and the userspace + tools <B +CLASS="COMMAND" +>smbmount</B +>, <B +CLASS="COMMAND" +>smbumount</B +>, + and <B +CLASS="COMMAND" +>smbmnt</B +> is <A +HREF="mailto:urban@teststation.com" +TARGET="_top" +>Urban Widmark</A +>.</P +><P +>The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter</P +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/docs/htmldocs/smbmount.8.html b/docs/htmldocs/smbmount.8.html new file mode 100644 index 00000000000..94a4ae8bc88 --- /dev/null +++ b/docs/htmldocs/smbmount.8.html @@ -0,0 +1,264 @@ +<HTML +><HEAD +><TITLE +>smbmount</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD +><BODY +CLASS="REFENTRY" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><H1 +><A +NAME="SMBMOUNT" +>smbmount</A +></H1 +><DIV +CLASS="REFNAMEDIV" +><A +NAME="AEN5" +></A +><H2 +>Name</H2 +>smbmount -- mount and smbfs filesystem</DIV +><DIV +CLASS="REFSYNOPSISDIV" +><A +NAME="AEN8" +></A +><H2 +>Synopsis</H2 +><P +><B +CLASS="COMMAND" +>smbumount</B +> {service} {mount-point} [-o options]</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN14" +></A +><H2 +>DESCRIPTION</H2 +><P +><B +CLASS="COMMAND" +>smbmount</B +> mounts a SMB filesystem. It + is usually invoked as <B +CLASS="COMMAND" +>mount.smb</B +> from + the <B +CLASS="COMMAND" +>mount(8)</B +> command when using the + "-t smb" option. The kernel must support the smbfs filesystem. </P +><P +>Options to smbmount are specified as a comma separated list + of key=value pairs.</P +><P +><I +CLASS="EMPHASIS" +>NOTE:</I +> <B +CLASS="COMMAND" +>smbmount</B +> + calls <B +CLASS="COMMAND" +>smbmnt(8)</B +> to do the actual mount. You + must make sure that <B +CLASS="COMMAND" +>smbmnt</B +> is in the path so + that it can be found. </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN26" +></A +><H2 +>OPTIONS</H2 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>username=<arg></DT +><DD +><P +>specifies the username to connect as. If + this is not given then the environment variable <TT +CLASS="PARAMETER" +><I +> $USER</I +></TT +> is used. This option can also take the + form "user%password" or "user/workgroup" or + "user/workgroup%password" to allow the password and workgroup + to be specified as part of the username.</P +></DD +><DT +>password=<arg></DT +><DD +><P +>specifies the SMB password. If not given then + <B +CLASS="COMMAND" +>smbmount</B +> will prompt for a passeword, unless + the guest option is given. </P +></DD +><DT +>netbiosname=<arg></DT +><DD +><P +>sets the source NetBIOS name. It defaults + to the local hostname. </P +></DD +><DT +>uid=<arg></DT +><DD +><P +>sets the uid that files will be mounted as. + It may be specified as either a username or a numeric uid. + </P +></DD +><DT +>gid=<arg></DT +><DD +><P +>sets the gid that files will be mounted as. + It may be specified as either a groupname or a numeric + gid. </P +></DD +><DT +>port=<arg></DT +><DD +><P +>sets the remote SMB port number. The default + is 139. </P +></DD +><DT +>fmask=<arg></DT +><DD +><P +>sets the file mask. This determines the + permissions that remote files have in the local filesystem. + The default is based on the current umask. </P +></DD +><DT +>dmask=<arg></DT +><DD +><P +>sets the directory mask. This deterines the + permissions that remote directories have in the local filesystem. + The default is based on the current umask. </P +></DD +><DT +>debug=<arg></DT +><DD +><P +>sets the debug level. This is useful for + tracking down SMB connection problems. </P +></DD +><DT +>ip=<arg></DT +><DD +><P +>sets the destination host or IP address. + </P +></DD +><DT +>workgroup=<arg></DT +><DD +><P +>sets the workgroup on the destination </P +></DD +><DT +>sockopt=<arg></DT +><DD +><P +>sets the TCP socket options. See the <A +HREF="smb.conf.5.html#SOCKETOPTIONS" +TARGET="_top" +><TT +CLASS="FILENAME" +>smb.conf + </TT +></A +> <TT +CLASS="PARAMETER" +><I +>socket options</I +></TT +> option. + </P +></DD +><DT +>scope=<arg></DT +><DD +><P +>sets the NetBIOS scope </P +></DD +><DT +>guest</DT +><DD +><P +>don't prompt for a password </P +></DD +><DT +>ro</DT +><DD +><P +>mount read-only </P +></DD +><DT +>rw</DT +><DD +><P +>mount read-write </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN98" +></A +><H2 +>AUTHOR</H2 +><P +>The current maintainer of smbfs and the userspace + tools <B +CLASS="COMMAND" +>smbmount</B +>, <B +CLASS="COMMAND" +>smbumount</B +>, + and <B +CLASS="COMMAND" +>smbmnt</B +> is <A +HREF="mailto:urban@teststation.com" +TARGET="_top" +>Urban Widmark</A +></P +><P +>The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter</P +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/docs/htmldocs/smbumount.8.html b/docs/htmldocs/smbumount.8.html new file mode 100644 index 00000000000..cdecec69a19 --- /dev/null +++ b/docs/htmldocs/smbumount.8.html @@ -0,0 +1,130 @@ +<HTML +><HEAD +><TITLE +>smbumount</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD +><BODY +CLASS="REFENTRY" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><H1 +><A +NAME="SMBUMOUNT" +>smbumount</A +></H1 +><DIV +CLASS="REFNAMEDIV" +><A +NAME="AEN5" +></A +><H2 +>Name</H2 +>smbumount -- smbfs umount for normal users</DIV +><DIV +CLASS="REFSYNOPSISDIV" +><A +NAME="AEN8" +></A +><H2 +>Synopsis</H2 +><P +><B +CLASS="COMMAND" +>smbumount</B +> {mount-point}</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN12" +></A +><H2 +>DESCRIPTION</H2 +><P +>With this program, normal users can unmount smb-filesystems, + provided that it is suid root. <B +CLASS="COMMAND" +>smbumount</B +> has + been written to give normal linux-users more control over their + resources. It is safe to install this program suid root, because only + the user who has mounted a filesystem is allowed to unmount it again. + For root it is not necessary to use smbumount. The normal umount + program works perfectly well, but it would certainly be problematic + to make umount setuid root.</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN16" +></A +><H2 +>OPTIONS</H2 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>mount-point</DT +><DD +><P +>The directory to unmount.</P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN23" +></A +><H2 +>SEE ALSO</H2 +><P +><A +HREF="smbmount.8.html" +TARGET="_top" +><B +CLASS="COMMAND" +>smbmount(8)</B +> + </A +></P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN28" +></A +><H2 +>AUTHOR</H2 +><P +>The current maintainer of smbfs and the userspace + tools <B +CLASS="COMMAND" +>smbmount</B +>, <B +CLASS="COMMAND" +>smbumount</B +>, + and <B +CLASS="COMMAND" +>smbmnt</B +> is <A +HREF="mailto:urban@teststation.com" +TARGET="_top" +>Urban Widmark</A +>.</P +><P +>The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter</P +></DIV +></BODY +></HTML +>
\ No newline at end of file |