~ubuntu-branches/ubuntu/natty/davfs2/natty

« back to all changes in this revision

Viewing changes to INSTALL.davfs2

  • Committer: Bazaar Package Importer
  • Author(s): Luciano Bello
  • Date: 2009-06-15 18:53:30 UTC
  • mfrom: (4.1.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090615185330-w0sig45by20gau13
Tags: 1.4.1-1
* New upstream version 1.4.1 (closes: #533057).
* Upstream location updated in copyright (closes: #533056).
* Debhelper compatibility version updated to 7.
* Standards-Version updated to 3.8.1.
* dh_clean -k was changed for dh_prep.
* /var/run/mount.davfs/ is not created during the instalation.
* New/improved debconf translations available:
  - Spanish translation (closes: #526721).
  - Japanese translation (closes: #528175).
* libneon27 had been switched for libneon27-gnutls (closes: #533058).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
2008-07-12
2
 
----------
3
 
 
4
 
DAVFS2 1.3.2 INSTALLATION
5
 
=========================
6
 
 
7
 
    1 UPDATING FROM PREVIOUS VERSION
8
 
    2 INSTALLATION
9
 
        2.1 PREREQUISITE
10
 
        2.2 INSTALLATION FROM CVS SOURCES
11
 
        2.3 INSTALLATION FROM SOURCE PACKAGE
12
 
    3 UNINSTALL
13
 
    
14
 
 
15
 
1 UPDATING FROM PREVIOUS VERSION
16
 
================================
17
 
 
18
 
'make install' copies new versions of davfs2.conf and secrets
19
 
into /usr/local/etc/davfs2 or /etc/davfs2 and creates a backup of the
20
 
existing files. You will have to merge your changes from the backup
21
 
into the new files.
22
 
 
23
 
When a user invokes the new version of mount.davfs thefirst time, it
24
 
will only copy new versions of davfs2.conf and secrets into ~/.davfs2,
25
 
if this files do not exist. The user should rename this files before
26
 
invoking mount.davfs. After the new configuration files have been
27
 
installed the user may merge the changes form the old files into
28
 
the new versions.
29
 
 
30
 
 
31
 
UPDATING FROM 1.0.x
32
 
-------------------
33
 
 
34
 
In davfs2 1.1.0 the organization of the permanent cache has changed
35
 
compared to the 1.0.x releases and the cache needs to be rebuild. Files
36
 
in the backup directory will be lost. So before installing the new version,
37
 
you should start your old version of mount.davfs a last time and save all
38
 
the files from the backup directory you may need some day.
39
 
 
40
 
 
41
 
2 INSTALLATION
42
 
==============
43
 
 
44
 
2.1 PREREQUISITE
45
 
----------------
46
 
 
47
 
davfs2 uses the neon libraries for communication with the server.
48
 
libneon (2.5, 2.6, 2.7 or 2.8) must be installed. Your distribution will most
49
 
likely provide a package.
50
 
You will also need the neon header files. Distributions usually provide
51
 
development packages for this.
52
 
If your distribution don't come with libneon or it does not support TLS and
53
 
large files, you may build your own neon library. You can get it from
54
 
http://www.webdav.org/neon/
55
 
 
56
 
Your kernel must include either the coda file system or the fuse file system
57
 
or both. They may be loadable modules. Almost all Linux 2.4 and 2.6 kernels
58
 
support at least one of them.
59
 
 
60
 
 
61
 
2.2 INSTALLATION FROM CVS SOURCES
62
 
---------------------------------
63
 
 
64
 
To build davfs2 from the CVS sources you need recent versions of the some
65
 
build tools:
66
 
 
67
 
- GNU Autoconf 2.61 or newer
68
 
- GNU Automake 1.10 or newer
69
 
- GNU gettext-tools 0.16.1 or newer
70
 
- po4a 0.29 or newer
71
 
 
72
 
Change into the top level source directory and run
73
 
    $ ./bootstrap
74
 
    This will add some necessary files, create the configure script and the
75
 
    Makefile.in's, and build the translated man pages from the po-files.
76
 
 
77
 
Proceed with Installation from Source Package.
78
 
 
79
 
 
80
 
2.3 INSTALLATION FROM SOURCE PACKAGE
81
 
------------------------------------
82
 
 
83
 
From within the top level source directory:
84
 
 
85
 
- Run the configure script.
86
 
    $ ./configure [options]
87
 
    This will test your system and finally create the appropriate Makefiles.
88
 
    You may add some options or set some variables, but hopefully will not
89
 
    have to.
90
 
 
91
 
    Options and variables:
92
 
    ----------------------
93
 
 
94
 
    --prefix=<prefix>
95
 
        Defines the directory where davfs2 will be installed. It defaults to
96
 
        '/usr/local'. If your sources came with your distribution it may
97
 
        be '/usr'.
98
 
 
99
 
    --with-neon=<directory>
100
 
        Directory where to find the neon library and the neon headers.
101
 
        Default is to first try /usr/local and then /usr. If you just have
102
 
        neon liebraries in /usr/lib and headers in /usr/include, you don't
103
 
        need this.
104
 
 
105
 
    --disable-nls
106
 
        Disable the support for national lanuages.
107
 
 
108
 
    LINGUAS="ll ll ll"
109
 
        A list of two-letter language codes. This will select which of the
110
 
        available translations of messages and documentation will be installed.
111
 
        ll must be in lower case.
112
 
 
113
 
    dav_user=<davfs2>
114
 
        A system user without shell. mount.davfs will run with this id when
115
 
        invoked by root. Default dav_user is "davfs2".
116
 
 
117
 
    dav_group=<davfs2>
118
 
        A system group. mount.davfs will be member of this group. Normal users
119
 
        must be member of this group in order to mount. Default dav_group is
120
 
        "davfs2".
121
 
    
122
 
    ./configure --help will show all available options.
123
 
        
124
 
- Run make.
125
 
    $ make
126
 
    This will compile the program.
127
 
 
128
 
- Gain root permissions and run make install.
129
 
    # make install
130
 
    This will copy all the files in the appropriate directory.
131
 
    Note: 'mount.davfs' will be setuid!
132
 
 
133
 
- Create the system user 'davfs2' and group 'davfs2' if they not yet exist.
134
 
  The system user should not have a shell. Proposed home directory is
135
 
  '/var/cache/davfs2'.
136
 
 
137
 
- Get rid of the root permissions.
138
 
 
139
 
 
140
 
3 UNINSTALL
141
 
===========
142
 
 
143
 
To uninstall davfs2 the sources have to be configured just the same way
144
 
they were configured for installation.
145
 
 
146
 
From within the top level source directory run with root permissions
147
 
    # make uninstall
148
 
    This will remove all the installed files.
149
 
 
150
 
Note: The directories will not be removed.
151
 
      Files and directories created by mount.davfs at run-time will *not* be
152
 
      removed too.
153
 
      This are: pid-files (in /var/run/mount.davfs), cache files and
154
 
      directories (in /var/cache/davfs2) and all the files in the users
155
 
      home directories in .davfs2.
156
 
      This files have to be removed manually.