~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/server.txt

  • Committer: Brad Crittenden
  • Date: 2007-03-02 12:40:45 UTC
  • mto: This revision was merged to the branch mainline in revision 2311.
  • Revision ID: bac@canonical.com-20070302124045-3a9o45va231z0w0a
post review changes

Show diffs side-by-side

added added

removed removed

Lines of Context:
18
18
 
19
19
Bazaar supports writing over FTP, SFTP and via a plugin over HTTP-WebDAV.
20
20
 
21
 
High performance server
 
21
High-performance server
22
22
=======================
23
23
 
24
24
**In development**
25
25
 
26
 
The high performance server is currently in development.  The version of Bazaar
 
26
The high-performance server is currently in development.  The version of Bazaar
27
27
that accompanies this documentation is able to use the servers underlying
28
 
protocol as a dumb server.  This is the first stage high performance server
 
28
protocol as a dumb server.  This is the first stage high-performance server
29
29
functionality to be delivered.
30
30
 
31
 
The current high performance server provides read-only access by
32
 
default for security. To enable read-write access, run it with
33
 
``--allow-writes``. When using the SSH access method, bzr
34
 
automatically runs with with the ``--allow-writes`` option.
 
31
To maintain the highest security possible, the current
 
32
high-performance server provides read-only access by default.  To
 
33
enable read-write access, run it with ``--allow-writes``. When using
 
34
the SSH access method, bzr automatically runs with with the
 
35
``--allow-writes`` option.
35
36
 
36
37
The server can be configured to run in three different ways:
37
38
 
42
43
 
43
44
    BZR_REMOTE_PATH=~/bin/bzr bzr log bzr+ssh://host/path/to/branch
44
45
 
45
 
The ``BZR_REMOTE_PATH`` environment variable adjusts how `bzr` will be invoked on
46
 
the remote system.  By default, just `bzr` will be invoked, which requires the
47
 
`bzr` executable to be on the default search path.
 
46
The ``BZR_REMOTE_PATH`` environment variable adjusts how `bzr` will be
 
47
invoked on the remote system.  By default, just `bzr` will be invoked,
 
48
which requires the `bzr` executable to be on the default search path.
48
49
 
49
 
The ``bzr+ssh://`` URL scheme only supports absolute paths from the root of the
50
 
filesystem.  Future versions are expected to support ``~`` in the same way as
51
 
``sftp://`` URLs.
 
50
The ``bzr+ssh://`` URL scheme only supports absolute paths from the
 
51
root of the filesystem.  Future versions are expected to support ``~``
 
52
in the same way as ``sftp://`` URLs.
52
53
 
53
54
inetd
54
55
-----
69
70
Dedicated
70
71
---------
71
72
 
72
 
This mode has the same path and URL behaviour as the inetd mode.  To run as a
73
 
specific user, you should use ``su`` or login as that user.  This example runs ``bzr
74
 
serve`` on `localhost` port `1234`.
 
73
This mode has the same path and URL behaviour as the inetd mode.  To
 
74
run as a specific user, you should use ``su`` or login as that user.
 
75
This example runs ``bzr serve`` on `localhost` port `1234`.
75
76
 
76
77
server::
77
78