Documentation/Changes

   1 Intro
   2 =====
   3
   4 This document is designed to provide a list of the minimum levels of
   5 software necessary to run the 3.0 kernels.
   6
   7 This document is originally based on my "Changes" file for 2.0.x kernels
   8 and therefore owes credit to the same people as that file (Jared Mauch,
   9 Axel Boldt, Alessandro Sigala, and countless other users all over the
  10 'net).
  11
  12 Current Minimal Requirements
  13 ============================
  14
  15 Upgrade to at *least* these software revisions before thinking you've
  16 encountered a bug!  If you're unsure what version you're currently
  17 running, the suggested command should tell you.
  18
  19 Again, keep in mind that this list assumes you are already functionally
  20 running a Linux kernel.  Also, not all tools are necessary on all
  21 systems; obviously, if you don't have any ISDN hardware, for example,
  22 you probably needn't concern yourself with isdn4k-utils.
  23
  24 o  Gnu C                  3.2                     # gcc --version
  25 o  Gnu make               3.80                    # make --version
  26 o  binutils               2.12                    # ld -v
  27 o  util-linux             2.10o                   # fdformat --version
  28 o  kmod                   13                      # depmod -V
  29 o  e2fsprogs              1.41.4                  # e2fsck -V
  30 o  jfsutils               1.1.3                   # fsck.jfs -V
  31 o  reiserfsprogs          3.6.3                   # reiserfsck -V
  32 o  xfsprogs               2.6.0                   # xfs_db -V
  33 o  squashfs-tools         4.0                     # mksquashfs -version
  34 o  btrfs-progs            0.18                    # btrfsck
  35 o  pcmciautils            004                     # pccardctl -V
  36 o  quota-tools            3.09                    # quota -V
  37 o  PPP                    2.4.0                   # pppd --version
  38 o  isdn4k-utils           3.1pre1                 # isdnctrl 2>&1|grep version
  39 o  nfs-utils              1.0.5                   # showmount --version
  40 o  procps                 3.2.0                   # ps --version
  41 o  oprofile               0.9                     # oprofiled --version
  42 o  udev                   081                     # udevd --version
  43 o  grub                   0.93                    # grub --version || grub-install --version
  44 o  mcelog                 0.6                     # mcelog --version
  45 o  iptables               1.4.2                   # iptables -V
  46
  47
  48 Kernel compilation
  49 ==================
  50
  51 GCC
  52 ---
  53
  54 The gcc version requirements may vary depending on the type of CPU in your
  55 computer.
  56
  57 Make
  58 ----
  59
  60 You will need Gnu make 3.80 or later to build the kernel.
  61
  62 Binutils
  63 --------
  64
  65 Linux on IA-32 has recently switched from using as86 to using gas for
  66 assembling the 16-bit boot code, removing the need for as86 to compile
  67 your kernel.  This change does, however, mean that you need a recent
  68 release of binutils.
  69
  70 Perl
  71 ----
  72
  73 You will need perl 5 and the following modules: Getopt::Long, Getopt::Std,
  74 File::Basename, and File::Find to build the kernel.
  75
  76 BC
  77 --
  78
  79 You will need bc to build kernels 3.10 and higher
  80
  81
  82 System utilities
  83 ================
  84
  85 Architectural changes
  86 ---------------------
  87
  88 DevFS has been obsoleted in favour of udev
  89 (http://www.kernel.org/pub/linux/utils/kernel/hotplug/)
  90
  91 32-bit UID support is now in place.  Have fun!
  92
  93 Linux documentation for functions is transitioning to inline
  94 documentation via specially-formatted comments near their
  95 definitions in the source.  These comments can be combined with the
  96 SGML templates in the Documentation/DocBook directory to make DocBook
  97 files, which can then be converted by DocBook stylesheets to PostScript,
  98 HTML, PDF files, and several other formats.  In order to convert from
  99 DocBook format to a format of your choice, you'll need to install Jade as
 100 well as the desired DocBook stylesheets.
 101
 102 Util-linux
 103 ----------
 104
 105 New versions of util-linux provide *fdisk support for larger disks,
 106 support new options to mount, recognize more supported partition
 107 types, have a fdformat which works with 2.4 kernels, and similar goodies.
 108 You'll probably want to upgrade.
 109
 110 Ksymoops
 111 --------
 112
 113 If the unthinkable happens and your kernel oopses, you may need the
 114 ksymoops tool to decode it, but in most cases you don't.
 115 It is generally preferred to build the kernel with CONFIG_KALLSYMS so
 116 that it produces readable dumps that can be used as-is (this also
 117 produces better output than ksymoops).  If for some reason your kernel
 118 is not build with CONFIG_KALLSYMS and you have no way to rebuild and
 119 reproduce the Oops with that option, then you can still decode that Oops
 120 with ksymoops.
 121
 122 Mkinitrd
 123 --------
 124
 125 These changes to the /lib/modules file tree layout also require that
 126 mkinitrd be upgraded.
 127
 128 E2fsprogs
 129 ---------
 130
 131 The latest version of e2fsprogs fixes several bugs in fsck and
 132 debugfs.  Obviously, it's a good idea to upgrade.
 133
 134 JFSutils
 135 --------
 136
 137 The jfsutils package contains the utilities for the file system.
 138 The following utilities are available:
 139 o fsck.jfs - initiate replay of the transaction log, and check
 140   and repair a JFS formatted partition.
 141 o mkfs.jfs - create a JFS formatted partition.
 142 o other file system utilities are also available in this package.
 143
 144 Reiserfsprogs
 145 -------------
 146
 147 The reiserfsprogs package should be used for reiserfs-3.6.x
 148 (Linux kernels 2.4.x). It is a combined package and contains working
 149 versions of mkreiserfs, resize_reiserfs, debugreiserfs and
 150 reiserfsck. These utils work on both i386 and alpha platforms.
 151
 152 Xfsprogs
 153 --------
 154
 155 The latest version of xfsprogs contains mkfs.xfs, xfs_db, and the
 156 xfs_repair utilities, among others, for the XFS filesystem.  It is
 157 architecture independent and any version from 2.0.0 onward should
 158 work correctly with this version of the XFS kernel code (2.6.0 or
 159 later is recommended, due to some significant improvements).
 160
 161 PCMCIAutils
 162 -----------
 163
 164 PCMCIAutils replaces pcmcia-cs. It properly sets up
 165 PCMCIA sockets at system startup and loads the appropriate modules
 166 for 16-bit PCMCIA devices if the kernel is modularized and the hotplug
 167 subsystem is used.
 168
 169 Quota-tools
 170 -----------
 171
 172 Support for 32 bit uid's and gid's is required if you want to use
 173 the newer version 2 quota format.  Quota-tools version 3.07 and
 174 newer has this support.  Use the recommended version or newer
 175 from the table above.
 176
 177 Intel IA32 microcode
 178 --------------------
 179
 180 A driver has been added to allow updating of Intel IA32 microcode,
 181 accessible as a normal (misc) character device.  If you are not using
 182 udev you may need to:
 183
 184 mkdir /dev/cpu
 185 mknod /dev/cpu/microcode c 10 184
 186 chmod 0644 /dev/cpu/microcode
 187
 188 as root before you can use this.  You'll probably also want to
 189 get the user-space microcode_ctl utility to use with this.
 190
 191 udev
 192 ----
 193 udev is a userspace application for populating /dev dynamically with
 194 only entries for devices actually present.  udev replaces the basic
 195 functionality of devfs, while allowing persistent device naming for
 196 devices.
 197
 198 FUSE
 199 ----
 200
 201 Needs libfuse 2.4.0 or later.  Absolute minimum is 2.3.0 but mount
 202 options 'direct_io' and 'kernel_cache' won't work.
 203
 204 Networking
 205 ==========
 206
 207 General changes
 208 ---------------
 209
 210 If you have advanced network configuration needs, you should probably
 211 consider using the network tools from ip-route2.
 212
 213 Packet Filter / NAT
 214 -------------------
 215 The packet filtering and NAT code uses the same tools like the previous 2.4.x
 216 kernel series (iptables).  It still includes backwards-compatibility modules
 217 for 2.2.x-style ipchains and 2.0.x-style ipfwadm.
 218
 219 PPP
 220 ---
 221
 222 The PPP driver has been restructured to support multilink and to
 223 enable it to operate over diverse media layers.  If you use PPP,
 224 upgrade pppd to at least 2.4.0.
 225
 226 If you are not using udev, you must have the device file /dev/ppp
 227 which can be made by:
 228
 229 mknod /dev/ppp c 108 0
 230
 231 as root.
 232
 233 Isdn4k-utils
 234 ------------
 235
 236 Due to changes in the length of the phone number field, isdn4k-utils
 237 needs to be recompiled or (preferably) upgraded.
 238
 239 NFS-utils
 240 ---------
 241
 242 In ancient (2.4 and earlier) kernels, the nfs server needed to know
 243 about any client that expected to be able to access files via NFS.  This
 244 information would be given to the kernel by "mountd" when the client
 245 mounted the filesystem, or by "exportfs" at system startup.  exportfs
 246 would take information about active clients from /var/lib/nfs/rmtab.
 247
 248 This approach is quite fragile as it depends on rmtab being correct
 249 which is not always easy, particularly when trying to implement
 250 fail-over.  Even when the system is working well, rmtab suffers from
 251 getting lots of old entries that never get removed.
 252
 253 With modern kernels we have the option of having the kernel tell mountd
 254 when it gets a request from an unknown host, and mountd can give
 255 appropriate export information to the kernel.  This removes the
 256 dependency on rmtab and means that the kernel only needs to know about
 257 currently active clients.
 258
 259 To enable this new functionality, you need to:
 260
 261   mount -t nfsd nfsd /proc/fs/nfsd
 262
 263 before running exportfs or mountd.  It is recommended that all NFS
 264 services be protected from the internet-at-large by a firewall where
 265 that is possible.
 266
 267 mcelog
 268 ------
 269
 270 On x86 kernels the mcelog utility is needed to process and log machine check
 271 events when CONFIG_X86_MCE is enabled. Machine check events are errors reported
 272 by the CPU. Processing them is strongly encouraged.
 273
 274 Getting updated software
 275 ========================
 276
 277 Kernel compilation
 278 ******************
 279
 280 gcc
 281 ---
 282 o  <ftp://ftp.gnu.org/gnu/gcc/>
 283
 284 Make
 285 ----
 286 o  <ftp://ftp.gnu.org/gnu/make/>
 287
 288 Binutils
 289 --------
 290 o  <ftp://ftp.kernel.org/pub/linux/devel/binutils/>
 291
 292 System utilities
 293 ****************
 294
 295 Util-linux
 296 ----------
 297 o  <ftp://ftp.kernel.org/pub/linux/utils/util-linux/>
 298
 299 Kmod
 300 ----
 301 o  <https://www.kernel.org/pub/linux/utils/kernel/kmod/>
 302 o  <https://git.kernel.org/pub/scm/utils/kernel/kmod/kmod.git>
 303
 304 Ksymoops
 305 --------
 306 o  <ftp://ftp.kernel.org/pub/linux/utils/kernel/ksymoops/v2.4/>
 307
 308 Mkinitrd
 309 --------
 310 o  <https://code.launchpad.net/initrd-tools/main>
 311
 312 E2fsprogs
 313 ---------
 314 o  <http://prdownloads.sourceforge.net/e2fsprogs/e2fsprogs-1.29.tar.gz>
 315
 316 JFSutils
 317 --------
 318 o  <http://jfs.sourceforge.net/>
 319
 320 Reiserfsprogs
 321 -------------
 322 o  <http://www.kernel.org/pub/linux/utils/fs/reiserfs/>
 323
 324 Xfsprogs
 325 --------
 326 o  <ftp://oss.sgi.com/projects/xfs/>
 327
 328 Pcmciautils
 329 -----------
 330 o  <ftp://ftp.kernel.org/pub/linux/utils/kernel/pcmcia/>
 331
 332 Quota-tools
 333 ----------
 334 o  <http://sourceforge.net/projects/linuxquota/>
 335
 336 DocBook Stylesheets
 337 -------------------
 338 o  <http://sourceforge.net/projects/docbook/files/docbook-dsssl/>
 339
 340 XMLTO XSLT Frontend
 341 -------------------
 342 o  <http://cyberelk.net/tim/xmlto/>
 343
 344 Intel P6 microcode
 345 ------------------
 346 o  <https://downloadcenter.intel.com/>
 347
 348 udev
 349 ----
 350 o <http://www.freedesktop.org/software/systemd/man/udev.html>
 351
 352 FUSE
 353 ----
 354 o <http://sourceforge.net/projects/fuse>
 355
 356 mcelog
 357 ------
 358 o <http://www.mcelog.org/>
 359
 360 Networking
 361 **********
 362
 363 PPP
 364 ---
 365 o  <ftp://ftp.samba.org/pub/ppp/>
 366
 367 Isdn4k-utils
 368 ------------
 369 o  <ftp://ftp.isdn4linux.de/pub/isdn4linux/utils/>
 370
 371 NFS-utils
 372 ---------
 373 o  <http://sourceforge.net/project/showfiles.php?group_id=14>
 374
 375 Iptables
 376 --------
 377 o  <http://www.iptables.org/downloads.html>
 378
 379 Ip-route2
 380 ---------
 381 o  <ftp://ftp.tux.org/pub/net/ip-routing/iproute2-2.2.4-now-ss991023.tar.gz>
 382
 383 OProfile
 384 --------
 385 o  <http://oprofile.sf.net/download/>
 386
 387 NFS-Utils
 388 ---------
 389 o  <http://nfs.sourceforge.net/>
 390