Added some line breaks in BOOTPROTO section.
[opensuse:chkpnts-sysconfig.git] / doc / README.no_more_hardwaredescriptions
1
2 FIXME: This doc still has to be rewritten
3        This is just the mail i sent to opensuse-packaging@opensuse.org
4
5 -----------------------------------------------------------------------
6
7 Hi all,
8
9 there are two significant changes in sysconfig package:
10 - /sbin/getcfg removed
11 - /sbin/hw{up,down,status} removed
12
13 getcfg
14 ^^^^^^
15 Since some time we provide persistent network interface names.
16 Therefore we don't need to work with hardware descriptions in network
17 setup scripts. From now on we will name network configuration files
18 again ifcfg-<interface> and nothing else.
19
20 /sbin/getcfg/ was formerly necessary
21 - to get the current interface name from a hardware description
22     -> obsolete
23 - to find the right configuration file
24     -> obsolete
25 - to provide information about the device/interface
26     -> obsolete (sysfs has improved in between)
27 - to do some special tricks on S390
28     -> will move into some S390-package
29
30 There are still some other packages which use getcfg. If you are
31 maintainer of such an package please remove getcfg from it. For
32 possible configuration files that contain hardware descriptions i will
33 provide a conversion tool. Just contact me in such a case or for other
34 questions.
35
36 hwup
37 ^^^^
38 From now on we call modprobe in /etc/udev/rules.d/80-driver.rules
39 directly. hwup is no longer used and therefore all hwcfg-* files are
40 obsolete. Since most of these configs contain just the default driver
41 we don't convert them. They will just be dropped.
42 If some device needs some special driver, this may be configured in
43 udev rules more flexible then before.
44 Module options belong to modprobe.conf. It was a big mistake that they
45 could ever be written in hwcfg-*.
46 Manual device control is provided by sysfs:
47 - to release a device:
48     echo -n <device id> > /sys/bus/*/drivers/*/unbind
49 - to activate a device:
50     echo -n add > /sys/devices/..../uevent
51
52
53 The sysconfig package in next beta will still contain getcfg and hwup, but does
54 not use them itself. 
55
56
57
58
59 -----------------------------------------------------------------------------
60
61 TODO:
62 - mail the maintainer of packages that needs to be fixed
63 - convert all identified configuration files
64 - write getcfg script, that can
65   - convert hwdescs
66   - inform the user (also in the logfiles)
67
68 - Adopt the documentation
69   - /usr/src/linux/Documentation/networking/bonding.txt
70     they should refer to our manual pages
71
72
73 -----------------------------------------------------------------------------
74
75 Removed:
76 - getcfg: ifcfg-<interface> only
77 - PERSISTENT_NAME
78
79
80 Variables, the will be removed completely:
81 HWDESC
82
83
84 Problems:
85 - scpm
86 - get rid of TUNNEL_LOCAL_INTERFACE
87