Imported Debian patch 2.3.1-76
[debian/makedev] / debian / old / README.debian
1 makedev for DEBIAN
2 ==================
3
4 The /etc/makedev.cfg and /etc/devinfo files are rewritten to fit the
5 Debian /dev layout.
6
7 Security : all mouse devices are changed to mode 600. Only serial
8 devices are mode 660 root:dialout. It's possible to crash x11 and
9 console with writing random bytes to a mouse device.
10
11 Serial console :
12 /dev/console should be a symlink to your real console device.
13 If it does not exist, or is not a symlink, it will be replaced with a
14 symlink console -> tty0.
15
16 This version of makedev will check /dev for tty*/pty* devices, and if
17 there are some with the old major number, it will create a
18 /etc/rc.boot/makedev script. This will script will change the
19 master/slave devices the next time you boot.
20
21 serial devices should be owned by user "uucp" and group "dialout".
22 former they were owned by root. new devices are created with uucp as
23 owner, but you will have to change old devices to user uucp on your own.
24 It's new policy to have all serial devices owned by uucp, but the last
25 word in this discussion isn't said...
26
27 some device names have changed. please read
28 /usr/doc/makedev/devices.{txt|html}
29
30 the permissions should be secure enough, but if you find any bugs, or
31 unfounded hard permissions, please let me know (i don't know much about
32 the right permissions for devices, i yust used the value, everybody else
33 was using, and made read & write only available for root, whenever i
34 found nothing better.
35
36 /dev/console is now a symlink to /dev/tty0. for more infomation, please
37 look at a new 2.1 linux kernel : Documentation/devices.txt. That is the
38 "Linux Allocated Device" paper, the official list of linux devices.
39 If your boot console is a serial device, you will have to change that
40 symlink.
41
42 MAKEDEV-C will not work with any kernel with mcdx support, if
43 /proc/devices contains "Mitsumi CD-ROM". if so, patch
44 /usr/src/linux/driver/cdrom/mcdx.c :
45 1149c1149
46 <     if (unregister_blkdev(MAJOR_NR, "mcdx") != 0) {
47 ---
48 >     if (unregister_blkdev(MAJOR_NR, DEVICE_NAME) != 0) {
49 1270c1270
50 <               if (register_blkdev(MAJOR_NR, "mcdx", &mcdx_fops) != 0) {
51 ---
52 >               if (register_blkdev(MAJOR_NR, DEVICE_NAME, &mcdx_fops) != 0) {
53
54
55 about call out devices (/dev/cu*) :
56
57       /dev/ttySxx devices are fully POSIX-compliant TTY devices.  If you
58       are only going to be using one set of tty devices, you should be
59       using /dev/ttySxx.
60
61       /dev/cuaXX devices are different from /dev/ttySXX in two ways ---
62       first of all, they will allow you to open the device even if
63       CLOCAL is not set and the O_NONBLOCK flag was not given to the
64       open device.  This allows programs that don't use the
65       POSIX-mondated interface for opening /dev/ttySxx devices to be
66       able to use /dev/cuaXX to make outgoing phone calls on their modem
67       (cu stands for "callout", and is taken from SunOS).
68
69       The second way in which /dev/cuaXX differs from /dev/ttySXX is
70       that if they are used, they will trigger a simplistic kernel-based
71       locking scheme: If /dev/ttySXX is opened by one or more processes,
72       then an attempt to open /dev/cuaXX will return EAGAIN.  If
73       /dev/cuaXX is opened by one or more processes, then an attempt to
74       open /dev/ttySXX will result the open blocking until /dev/cuaXX is
75       closed, and the carrier detect line goes high. the open blocking
76       until /dev/cuaXX is closed, and the carrier detect line goes high.
77
78       While this will allow for simple lockouts between a user using a
79       modem for callout and a getty listening on the line for logins, it
80       doesn't work if you need to arbitrate between multiple programs
81       wanting to do dialout --- for example, users wanting to do dialout
82       and UUCP.
83
84       I originally implemented the cuaXX/ttySXX lockout mechanism back
85       before FSSTND established a standard convention for the use of tty
86       lock files.  Now that it's there, people should use the tty lock
87       files and not try using /dev/cuaXX.  The only reason why
88       /dev/cuaXX hasn't disappeared yet is for backwards compatibility
89       reasons.                    -- Theodore Ts'o <tytso@mit.edu>
90
91
92 debian has no /dev/cu* devices. But you can create them, if you need
93 them. Read devices.txt for details.
94
95 Andreas Jellinghaus <aj@debian.org>, Sun, 13 Apr 1997 21:05:58 +0200