← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/samba/intrepid-updates

« back to all changes in this revision

Viewing changes to docs-xml/manpages-3/vfs_readonly.8.xml

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2008-06-02 09:01:46 UTC
  • mfrom: (0.25.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20080602090146-92ur4nx39ccg708r
Tags: 2:3.0.30-2ubuntu1
https://launchpad.net/bugs/32067
https://launchpad.net/bugs/201059
https://launchpad.net/bugs/206036
* Merge from debian unstable, remaining changes:
  * debian/patches/VERSION.patch
    - set SAMABA_VERSION_VENDOR_SUFFIX to Ubuntu
  * debian/smb.conf
    - add "(Samba, Ubuntu)" to server string.
    - comment out the default [homes] shares, and a comment about
      "value users = %S to show users how to restrict access to 
      \\server\useranem to only username.
    - Add map to guest = Bad user, maps bad username to guest access.
      (LP: #32067)
  * debian/samba-common.postinst:
    - Fix upgrade from a first installation done with feisty, edgy, or dapper.
      (LP: #201059)
    - When populating the new sambashare group, it's not an error if the user
      simply doesn't exist; test for this case and the install continue 
      instead of aborting. (LP: #206036)
  * debian/smba-common.config:
    - do not change priority to HIGH if dhclient3 is installed
    - used priority medium instead of hight for the workgroup question
  * debian/winbind.files
    - insclude additional files
  * debian/patches/fix-documentation.patch:
    - fix typos in net(8) and smb.conf(5) man pages
  * debian/mksambapasswd.awk:
    - Don't add user with UID less than 1000 to smbpasswd.
  * debian/samba.init:
    - add 'status' option for LSB conformance.
  * Updated control version.
  * Dropped Changes:
    - Dropped debian/patches/fix-smbprinting-os2.patch. Accepted upstream.
    - Dropped debian/patches/fix-documentation.patch. Accepted upstream.
     

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/manpages-3/vfs_readonly.8.xml
 
1
<?xml version="1.0" encoding="iso-8859-1"?>
 
2
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
 
3
<refentry id="vfs_readonly.8">
 
4
 
 
5
<refmeta>
 
6
        <refentrytitle>vfs_readonly</refentrytitle>
 
7
        <manvolnum>8</manvolnum>
 
8
        <refmiscinfo class="source">Samba</refmiscinfo>
 
9
        <refmiscinfo class="manual">System Administration tools</refmiscinfo>
 
10
        <refmiscinfo class="version">3.0</refmiscinfo>
 
11
</refmeta>
 
12
 
 
13
 
 
14
<refnamediv>
 
15
        <refname>vfs_readonly</refname>
 
16
        <refpurpose>make a Samba share read only for a specified time period</refpurpose>
 
17
</refnamediv>
 
18
 
 
19
<refsynopsisdiv>
 
20
        <cmdsynopsis>
 
21
                <command>vfs objects = readonly</command>
 
22
        </cmdsynopsis>
 
23
</refsynopsisdiv>
 
24
 
 
25
<refsect1>
 
26
        <title>DESCRIPTION</title>
 
27
 
 
28
        <para>This VFS module is part of the
 
29
        <citerefentry><refentrytitle>samba</refentrytitle>
 
30
        <manvolnum>7</manvolnum></citerefentry> suite.</para>
 
31
 
 
32
        <para>The <command>vfs_readonly</command> VFS module marks a share
 
33
        as read only for all clients connecting within the configured
 
34
        time period. Clients connecting during this time will be denied
 
35
        write access to all files in the share, irrespective of ther
 
36
        actual access privileges.</para>
 
37
 
 
38
        <para>This module is stackable.</para>
 
39
 
 
40
</refsect1>
 
41
 
 
42
 
 
43
<refsect1>
 
44
        <title>OPTIONS</title>
 
45
 
 
46
        <variablelist>
 
47
 
 
48
                <varlistentry>
 
49
                <term>readonly:period = BEGIN, END</term>
 
50
                <listitem>
 
51
                <para>Only mark the share as read only if the client
 
52
                connection was made between the times marked by the
 
53
                BEGIN and END date specifiers.
 
54
                The syntax of these date specifiers is the
 
55
                same as that accepted by the -d option of GNU
 
56
                <citerefentry><refentrytitle>date</refentrytitle>
 
57
                        <manvolnum>1</manvolnum></citerefentry>.
 
58
                </para>
 
59
 
 
60
                </listitem>
 
61
                </varlistentry>
 
62
 
 
63
        </variablelist>
 
64
</refsect1>
 
65
 
 
66
<refsect1>
 
67
        <title>EXAMPLES</title>
 
68
 
 
69
        <para>Mark all shares read only:</para>
 
70
<programlisting>
 
71
        <smbconfsection name="[global]"/>
 
72
        <smbconfoption name="vfs objects">readonly</smbconfoption>
 
73
</programlisting>
 
74
 
 
75
        <para>Mark the [backup] share as read only during business hours:</para>
 
76
<programlisting>
 
77
        <smbconfsection name="[backup]"/>
 
78
        <smbconfoption name="path">/readonly</smbconfoption>
 
79
        <smbconfoption name="vfs objects">readonly</smbconfoption>
 
80
        <smbconfoption name="readonly:period">readonly:period = "today 9:00","today 17:00"</smbconfoption>
 
81
</programlisting>
 
82
</refsect1>
 
83
 
 
84
<refsect1>
 
85
        <title>VERSION</title>
 
86
 
 
87
        <para>This man page is correct for version 3.0.25 of the Samba suite.
 
88
        </para>
 
89
</refsect1>
 
90
 
 
91
<refsect1>
 
92
        <title>AUTHOR</title>
 
93
 
 
94
        <para>The original Samba software and related utilities
 
95
        were created by Andrew Tridgell. Samba is now developed
 
96
        by the Samba Team as an Open Source project similar
 
97
        to the way the Linux kernel is developed.</para>
 
98
 
 
99
</refsect1>
 
100
 
 
101
</refentry>