~ubuntu-branches/ubuntu/breezy/uucp/breezy

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Peter Palfrader
  • Date: 2004-12-30 15:30:22 UTC
  • mfrom: (2.1.1 warty)
  • Revision ID: james.westby@ubuntu.com-20041230153022-mx4cdr9j3u9bldo3
Tags: 1.07-12
Add cs localisation for debconf templates (closes: #287305).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
                        UUCP Documentation
 
3
 
 
4
0. INTRO
 
5
 
 
6
UUCP is nothing more then a file transfer protocol. Nowadays it's
 
7
mostly used to transfer offline mail and news. Most documentation
 
8
for it is in the manual pages and in the info files installed in
 
9
/usr/info/uucp*.
 
10
 
 
11
The Debian UUCP package is configured to use the taylor UUCP style
 
12
configuration files. While these files are more readable then the
 
13
"standard" HDB (Honey-Danber) configuration files there's less
 
14
documentation on it. However the config files supplied in /etc/uucp
 
15
are easy to setup. More elaborate exampes can be found in
 
16
/usr/share/doc/uucp/examples/taylor.
 
17
 
 
18
This package can also use the HDB configuration files instead of
 
19
taylor if you really want that. Examples for that can be found
 
20
in /usr/share/doc/uucp/examples/hdb.
 
21
 
 
22
1. FILE AND DIRECTORY LOCATIONS.
 
23
 
 
24
These might be a bit different then you're used to, so here's an overview:
 
25
 
 
26
/etc/uucp               Configuration files
 
27
/usr/bin                Programs to be executed by users
 
28
/usr/sbin               Programs to be executed by root or uucp
 
29
/usr/lib/uucp           Internal programs for the UUCP system, generally
 
30
                        not to be executed directly
 
31
/var/spool/uucp         UUCP spool directory
 
32
/var/spool/uucppublic   Public UUCP directory
 
33
/var/log/uucp           Logfile directory
 
34
 
 
35
The most outstanding differences with "traditional" systems are that the
 
36
logfiles are not in /var/spool/uucp, uucico is in /usr/sbin instead of
 
37
/usr/lib/uucp and the configuration files are in /etc/uucp instead of
 
38
also in /usr/lib/uucp.
 
39
 
 
40
2. SETTING UP A SIMPLE LEAF SITE.
 
41
 
 
42
a. Get a UUCP name from your provider, and a loginname and a password.
 
43
   Also ask for the provider's UUCP name and the telephone number.
 
44
b. Enter your providers UUCP name, loginname and password into /etc/uucp/call
 
45
c. If the UUCP name you got is not the same as your systems hostname,
 
46
   edit /etc/uucp/config and set the nodename to your systems UUCP name.
 
47
d. Enter the device your modem is connected to in /etc/uucp/port
 
48
e. Make an entry with the UUCP name of your provider in /etc/uucp/sys
 
49
 
 
50
If you are using a /dev/ttyS device (for example, /dev/ttyS1) to dialout
 
51
on, set the modes on /dev/ttyS1 to 660 and chgrp it to the "dialout" group.
 
52
That way, uucico (the file transfer engine) can access that port.
 
53
 
 
54
The same is true if you use a /dev/cua device but the permissions should
 
55
already be OK. (Use of the cua* ports is deprecated however).
 
56
 
 
57
Now you should be able to place a call to your provider and login
 
58
successfully with the command "uupoll <provider_uucp_name>". Beware
 
59
that if there are any mail messages for you and you have not setup
 
60
your mail system correctly that you might lose those messages.
 
61
 
 
62
 
 
63
 
 
64
3. MAINTENANCE AND POLLING THE OTHER SYSTEM AUTOMATICALLY.
 
65
 
 
66
You can add the uucp name, and a list of hours when you want your system
 
67
to call the providers UUCP system to the file /etc/uucp/Poll. This file
 
68
is examined hourly by the /usr/lib/uucp/uudemon.hr script to see if
 
69
the remote system(s) should be polled.
 
70
 
 
71
uudemon.hr is called from uucp's crontab in /etc/cron.d.  Job expiry is
 
72
started from the /etc/cron.daily/uucp script. See /etc/uucp/expire. Logs
 
73
are rotated with logrotate.
 
74
 
 
75
 
 
76
 
 
77
4. DEBIAN SPECIFIC PATCHES/BEHAVIOUR
 
78
 
 
79
* In port commands \H is substituted with the address assoziated with the
 
80
  system.  That allows you to use the same port (for instance an ssh port) for
 
81
  several systems.
 
82
 
 
83
* uucico supports a --grade option that limits outgoing call to a given grade.
 
84
 
 
85
* In order to have /etc/uucp root.uucp, i.e. not writeable by the uucp
 
86
  processes, it may be necessary that you start uucp related programs like
 
87
  uucico as user uucp.  For instance sudo -u uucp uucico... .
 
88
 
 
89
    /usr/share/doc/uucp/README          1.02  22-Feb-1998  miquels@cistron.nl
 
90
    /usr/share/doc/uucp/README.Debian         39-Jul-2002  weasel@debian.org