version 001
[platform/upstream/dracut.git] / NEWS
1 dracut-001
2 ==========
3 - better --hostonly checks
4 - better lvm/mdraid/dmraid handling
5 - fcoe booting support
6     Supported cmdline formats:
7     fcoe=<networkdevice>:<dcb|nodcb>
8     fcoe=<macaddress>:<dcb|nodcb>
9     
10     Note currently only nodcb is supported, the dcb option is reserved for
11     future use.
12     
13     Note letters in the macaddress must be lowercase!
14     
15     Examples:
16     fcoe=eth0:nodcb
17     fcoe=4A:3F:4C:04:F8:D7:nodcb
18
19 - Syslog support for dracut   
20     This module provides syslog functionality in the initrd.
21     This is especially interesting when complex configuration being
22     used to provide access to the device the rootfs resides on.
23
24
25 dracut-0.9
26 ==========
27 - let plymouth attach to the terminal (nice text output now)
28 - new kernel command line parameter "rdinfo" show dracut output, even when
29   "quiet" is specified
30 - rd_LUKS_UUID is now handled correctly
31 - dracut-gencmdline: rd_LUKS_UUID and rd_MD_UUID is now correctly generated
32 - now generates initrd-generic with around 15MB
33 - smaller bugfixes
34
35 dracut-0.8
36 ==========
37 - iSCSI with username and password
38 - support for live images (dmsquashed live images)
39 - iscsi_firmware fixes
40 - smaller images
41 - bugfixes
42
43 dracut-0.7
44 ==========
45 - dracut:     strip binaries in initramfs
46     
47            --strip
48                   strip binaries in the initramfs (default)
49     
50            --nostrip
51                   do not strip binaries in the initramfs
52 - dracut-catimages
53     
54     Usage: ./dracut-catimages [OPTION]... <initramfs> <base image>
55     [<image>...]
56     Creates initial ramdisk image by concatenating several images from the
57     command
58     line and /boot/dracut/
59     
60       -f, --force           Overwrite existing initramfs file.
61       -i, --imagedir        Directory with additional images to add
62                             (default: /boot/dracut/)
63       -o, --overlaydir      Overlay directory, which contains files that
64                             will be used to create an additional image
65       --nooverlay           Do not use the overlay directory
66       --noimagedir          Do not use the additional image directory
67       -h, --help            This message
68       --debug               Output debug information of the build process
69       -v, --verbose         Verbose output during the build process
70
71 - s390 dasd support
72
73 dracut-0.6
74 ==========
75 - dracut: add --kernel-only and --no-kernel arguments
76     
77            --kernel-only
78                   only install kernel drivers and firmware files
79     
80            --no-kernel
81                   do not install kernel drivers and firmware files
82     
83     All kernel module related install commands moved from "install"
84     to "installkernel".
85     
86     For "--kernel-only" all installkernel scripts of the specified
87     modules are used, regardless of any checks, so that all modules
88     which might be needed by any dracut generic image are in.
89     
90     The basic idea is to create two images. One image with the kernel
91     modules and one without. So if the kernel changes, you only have
92     to replace one image.
93     
94     Grub and the kernel can handle multiple images, so grub entry can
95     look like this:
96     
97     title Fedora (2.6.29.5-191.fc11.i586)
98             root (hd0,0)
99             kernel /vmlinuz-2.6.29.5-191.fc11.i586 ro rhgb quiet
100             initrd /initrd-20090722.img /initrd-kernel-2.6.29.5-191.fc11.i586.img /initrd-config.img
101     
102     initrd-20090722.img
103       the image provided by the initrd rpm
104       one old backup version is kept like with the kernel
105     
106     initrd-kernel-2.6.29.5-191.fc11.i586.img
107       the image provided by the kernel rpm
108     
109     initrd-config.img
110       optional image with local configuration files
111
112 - dracut: add --kmoddir directory, where to look for kernel modules
113     
114            -k, --kmoddir [DIR]
115                   specify the directory, where to look for kernel modules
116
117
118
119 dracut-0.5
120 ==========
121 - more generic (all plymouth modules, all keyboards, all console fonts)
122 - more kernel command line parameters (see also man dracut(8))
123 - a helper tool, which generates the kernel command line (dracut-gencmdline)
124 - bridged network boot
125 - a lot of new command line parameter
126
127 dracut-0.4
128 ==========
129 - bugfixes
130 - firmware loading support
131 - new internal queue (initqueue)
132     initqueue now loops until /dev/root exists or root is mounted
133     
134     init now has the following points to inject scripts:
135     
136     /cmdline/*.sh
137        scripts for command line parsing
138     
139     /pre-udev/*.sh
140        scripts to run before udev is started
141     
142     /pre-trigger/*.sh
143        scripts to run before the main udev trigger is pulled
144     
145     /initqueue/*.sh
146        runs in parallel to the udev trigger
147        Udev events can add scripts here with /sbin/initqueue.
148        If /sbin/initqueue is called with the "--onetime" option, the script
149        will be removed after it was run.
150        If /initqueue/work is created and udev >= 143 then this loop can
151        process the jobs in parallel to the udevtrigger.
152        If the udev queue is empty and no root device is found or no root
153        filesystem was mounted, the user will be dropped to a shell after
154        a timeout.
155        Scripts can remove themselves from the initqueue by "rm $job".
156     
157     /pre-mount/*.sh
158        scripts to run before the root filesystem is mounted
159        NFS is an exception, because it has no device node to be created
160        and mounts in the udev events
161     
162     /mount/*.sh
163        scripts to mount the root filesystem
164        NFS is an exception, because it has no device node to be created
165        and mounts in the udev events
166        If the udev queue is empty and no root device is found or no root
167        filesystem was mounted, the user will be dropped to a shell after
168        a timeout.
169     
170     /pre-pivot/*.sh
171        scripts to run before the real init is executed and the initramfs
172        disappears
173        All processes started before should be killed here.
174     
175     The behaviour of the dmraid module demonstrates how to use the new
176     mechanism. If it detects a device which is part of a raidmember from a
177     udev rule, it installs a job to scan for dmraid devices, if the udev
178     queue is empty. After a scan, it removes itsself from the queue.
179
180
181
182 dracut-0.3
183 ==========
184
185 - first public version
186