[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [RFR] templates://davfs2/{templates}



Kevin Coyner wrote:
> Below please find changes to the RFR version with comments.

So my diff is cumulative to everyone else's so far.

>  Template: davfs2/group_name
...
> - _Description: Group for the users allowed to mount WebDAV resources:
> 
> + _Description: Group for the users that will be allowed to mount
> + WebDAV resources:

That's getting a bit long.  How about

   _Description: Group for users who will be allowed to mount WebDAV resources:

Also where Christian has:

>  When mounting WebDAV resources, a file is created in
>  /var/run/mount.davfs. This directory will be owned by the group
>  entered here.

...strictly speaking that's a minor coordination error (the subject
of the main clause is the file, which isn't what does the mounting).
If it's worth avoiding the quickest fix is: 

   Mounting WebDAV resources creates a file in /var/run/mount.davfs.
   This directory will be owned by the group specified here.

(Or should that be "creates files"?)

>  Template: davfs2/non_root_users_confimed
...
>   usermod -a -G ${group_name} <username>

That's not the Debian way!  davfs2 depends on adduser, so let's use:

    adduser <username> ${group_name}         

>   The following should also be added to /etc/fstab:
>   .
>   https://webdav.site.com/path  /mnt  davfs  rw,users,noauto  0  0

Use the canonical example site:
    https://webdav.example.org/path  /mnt  davfs  rw,users,noauto  0  0

>  Package: davfs2
...
>  Description: mount WebDAV resources as regular file systems
> -  DAVFS2 is a Linux file system driver that allows mouting a WebDAV
> -  resource as a regular file system.
> 
> +  davfs2 is a Linux file system driver that allows mounting a
> +  WebDAV resource as a regular file system.
> 
> <kc> Should it be davfs2 or DAVFS2? I prefer davfs2.

As do upstream.

> - It allows files in a remote Web resource to be edited using standard
> - applications that interact with the file system (e.g.  text
> - editors). It uses coda for file system operations and the neon
> - library for WebDAV access. It supports SSL and proxy servers. The
> - code is based on uservfs (uservfs.sf.net).
> 
> + davfs2 allows files in a remote Web resource to be edited using standard
> + applications that interact with the file system (e.g.  text editors). It uses
> + coda for file system operations and the neon library for WebDAV access.
> + davfs2 also supports SSL and proxy servers. The code is based on uservfs
> + (uservfs.sf.net).
>
> <kc> Previously this paragraph had three sentences all beginning
> <kc> with "It".

And all referring to the same thing, so there's no need for them to
be separate sentences:

    davfs2 is a Linux file system driver that allows mounting a remote
    WebDAV resource as a regular file system, so that files in that resource
    can be edited using standard applications that interact with the file
    system (e.g. text editors). It supports SSL and proxy servers, uses coda
    for file system operations and the neon library for WebDAV access, and
    is based on uservfs.

I've also snipped the sourceforge reference; it seems unbalanced to
advertise a merely related sf.net page in a description that doesn't
mention its _own_ page at dav.sf.net.
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../davfs2.old/debian/templates	2007-05-10 16:40:35.000000000 +0100
+++ debian/templates	2007-05-19 15:25:13.000000000 +0100
@@ -1,62 +1,59 @@
 Template: davfs2/suid_file
 Type: boolean
 Default: false
-_Description: Do you want to allow non-root users mount WebDAV resources?
+_Description: Should unprivileged users be allowed to mount WebDAV resources?
  The file /sbin/mount.davfs must have the SUID bit set if you want to allow
- non-root users to mount webdav resources.
+ unprivileged (non-root) users to mount WebDAV resources.
  .
- Files with SUID root are normally avoided.
+ Choosing this option is discouraged for security reasons. If you
+ choose it, additional input will be required.
  .
- If you answer confirmative to this question, more details will be required. 
- Otherwise, non-root users can not mount webdav resources.
- .
- You can always change your opinion with "dpkg-reconfigure davfs2"
+ If you do not choose this option, only root will be allowed to mount WebDAV
+ resources. This can later be changed by running 'dpkg-reconfigure davfs2'.
 
 Template: davfs2/user_name
 Type: string
 Default: davfs2
-_Description: When invoked by root, the mount.davfs daemon will run as this user:
- mount.davfs starts with effective user-id 'root' to be able to mount. After
- mounting it changes its id permanently to that of the mounting user. When
- the mounting user is root, the mount.davfs daemon will run as the following declared user.
+_Description: User running the mount.davfs daemon:
+ Once the davfs resource has been mounted, the daemon will drop the
+ root privileges and will run with an unprivileged user ID.
+ .
+ Please choose which login name should be used by the daemon.
 
 Template: davfs2/group_name
 Type: string
 Default: davfs2
-_Description: The non-root users of davfs2 must be part of this group:
- For creating a file in /var/run/mount.davfs you must provide a group to
- own this directory. If you give a non-existant group, it will be created for
- you.
+ _Description: Group for users who will be allowed to mount WebDAV resources:
+ Mounting WebDAV resources creates a file in /var/run/mount.davfs.    
+ This directory will be owned by the group specified here.         
 
 Template: davfs2/new_user
 Type: boolean
 Default: true
-_Description: Do you want to create this new user?
- The user "${user_name}" will be created because it doesn't exist in your
- system and will be used by davfs2 if you answer confirmative.
+_Description: Do you want to create a new user?
+ The "${user_name}" user does not exist on the system and will be
+ created if you choose this option.
 
 Template: davfs2/new_group
 Type: boolean
 Default: true
-_Description: Do you want to create this new group?
- The group "${group_name}" will be created because it doesn't exist in your
- system and will be used by davfs2 if you answer confirmative.
+_Description: Do you want to create a new group?
+ The "${group_name}" group does not exist on the system and will be
+ created if you choose this option.
 
 Template: davfs2/non_root_users_confimed
 Type: note
-_Description: Non-root users can now mount webdav resources
- The group "${group_name}" and the user "${user_name}" will be used by davfs2. You must add to this
- group all your users that you want to grant access. Like this:
- .
- usermod -a -G ${group_name} <username>
+#flag:translate!:3,5
+_Description: Unprivileged users allowed to mount WebDAV resources
+ The "${group_name}" group and the "${user_name}" user will be used by
+ davfs2. All users who should be granted the right to mount WebDAV
+ resources should be added to the group "${group_name}" using the
+ following command:
  .
- Remember to add a line similar to this one in the /etc/fstab:
+ adduser <username> ${group_name}
  .
- https://webdav.site.com/path  /mnt  davfs  rw,users,noauto  0  0
+ The following should also be added to /etc/fstab:
  .
- Please, note that you should use http if your server doesn't support https
- connections. The mount point, the name of the server and the path must be
- adapted to your requirements.
+ https://webdav.example.org/path  /mnt  davfs  rw,users,noauto  0  0
  .
- More options can be used optionaly, please check the mount.davfs manpage
- for more information.
+ Additional options are available. Please read the mount.davfs man page.
--- ../davfs2.old/debian/control	2007-05-10 16:40:35.000000000 +0100
+++ debian/control	2007-05-19 15:14:19.000000000 +0100
@@ -10,9 +10,9 @@
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, adduser
 Description: mount a WebDAV resource as a regular file system
- DAVFS2 is a Linux file system driver that allows you to mount a WebDAV
- resource as a regular file system.  It allows files in a remote Web resource
- to be edited using standard applications that interact with the file system
- (e.g.  text editors). It uses coda for file system operations and the neon
- library for WebDAV access. It supports SSL and proxy servers. The code is
- based on uservfs (uservfs.sf.net).
+ davfs2 is a Linux file system driver that allows mounting a remote
+ WebDAV resource as a regular file system, so that files in that resource
+ can be edited using standard applications that interact with the file
+ system (e.g. text editors). It supports SSL and proxy servers, uses coda
+ for file system operations and the neon library for WebDAV access, and
+ is based on uservfs.
Template: davfs2/suid_file
Type: boolean
Default: false
_Description: Should unprivileged users be allowed to mount WebDAV resources?
 The file /sbin/mount.davfs must have the SUID bit set if you want to allow
 unprivileged (non-root) users to mount WebDAV resources.
 .
 Choosing this option is discouraged for security reasons. If you
 choose it, additional input will be required.
 .
 If you do not choose this option, only root will be allowed to mount WebDAV
 resources. This can later be changed by running 'dpkg-reconfigure davfs2'.

Template: davfs2/user_name
Type: string
Default: davfs2
_Description: User running the mount.davfs daemon:
 Once the davfs resource has been mounted, the daemon will drop the
 root privileges and will run with an unprivileged user ID.
 .
 Please choose which login name should be used by the daemon.

Template: davfs2/group_name
Type: string
Default: davfs2
 _Description: Group for users who will be allowed to mount WebDAV resources:
 Mounting WebDAV resources creates a file in /var/run/mount.davfs.    
 This directory will be owned by the group specified here.         

Template: davfs2/new_user
Type: boolean
Default: true
_Description: Do you want to create a new user?
 The "${user_name}" user does not exist on the system and will be
 created if you choose this option.

Template: davfs2/new_group
Type: boolean
Default: true
_Description: Do you want to create a new group?
 The "${group_name}" group does not exist on the system and will be
 created if you choose this option.

Template: davfs2/non_root_users_confimed
Type: note
#flag:translate!:3,5
_Description: Unprivileged users allowed to mount WebDAV resources
 The "${group_name}" group and the "${user_name}" user will be used by
 davfs2. All users who should be granted the right to mount WebDAV
 resources should be added to the group "${group_name}" using the
 following command:
 .
 adduser <username> ${group_name}
 .
 The following should also be added to /etc/fstab:
 .
 https://webdav.example.org/path  /mnt  davfs  rw,users,noauto  0  0
 .
 Additional options are available. Please read the mount.davfs man page.
Source: davfs2
Section: utils
Priority: extra
Maintainer: Luciano Bello <luciano@linux.org.ar>
Build-Depends: debhelper (>= 4.0.0), po-debconf, libssl-dev, libxml2-dev, libneon26-dev
Uploaders: Marcela Tiznado <mlt@debian.org>
Standards-Version: 3.7.2

Package: davfs2
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, adduser
Description: mount a WebDAV resource as a regular file system
 davfs2 is a Linux file system driver that allows mounting a remote
 WebDAV resource as a regular file system, so that files in that resource
 can be edited using standard applications that interact with the file
 system (e.g. text editors). It supports SSL and proxy servers, uses coda
 for file system operations and the neon library for WebDAV access, and
 is based on uservfs.

Reply to: