]> git.ipfire.org Git - thirdparty/util-linux.git/blobdiff - README
Merge branch 'uuid-time64_t' of https://github.com/thkukuk/util-linux
[thirdparty/util-linux.git] / README
diff --git a/README b/README
index b82609988728c23ad7885f087487ccfb7f1c4b79..b7c723da39cdd6ebcf9e0f3c07ece26238584c9e 100644 (file)
--- a/README
+++ b/README
-util-linux: Miscellaneous utilities for Linux
-%n util-linux
-%v 2.2
-%c *
-%l *
-%b *
-%d *
-%f ftp.cs.unc.edu:/pub/users/faith/linux
-%t util-linux-2.2.tar.gz
-%w utils
-%%
-# These lines describe an automated build procedure, please ignore them.
-%setup
-make
-%doc ANNOUNCE LSM README
-%doc COPYING.GPL COPYING.UCB
-%doc ./time/README.time ./disk-utils/README.cfdisk
-%doc ./disk-utils/README.fdisk ./disk-utils/README.bootutils-0.1
-%doc ./sys-utils/README.setserial ./makedev-1.4.1/README.MAKEDEV-C
-%doc ./misc-utils/README.script ./misc-utils/README.hostname
-%doc ./misc-utils/README.namei ./misc-utils/README.cal
-%doc ./misc-utils/README1.namei ./text-utils/README.col
-%doc ./mount/README.mount
-%doc ./login-utils/README.getty ./login-utils/README.admutil
-%doc ./login-utils/README.poeigl
-cp -a $BUILDDIR/$NAME-$VERSION/example.files /usr/doc/$WHERE/$NAME-$VERSION
-* rm -rf /usr/lib/zoneinfo
-* make install
-%i set -x
-%i /usr/sbin/zic -l US/Eastern
-%i /usr/sbin/zic -p America/New_York
-%i set +x
-%i echo 'WARNING: Check time zone!  (If necessary, change with zic).'
-%i echo 'WARNING: Check /etc/rc for initalization of /var/adm/utmp'
-%i echo 'WARNING: /etc/rc should run /sbin/update, *NOT* /sbin/bdflush'
-exit
-# Please ignore the previous lines. . .
-# The informative part of the notes file starts here:
-
-WARNING: THE PROGRAMS IN THIS SUITE DO *NOT* SUPPORT SHADOW PASSWORD FILES!
-
-WARNING: THIS COLLECTION DOES *NOT* SUPPORT SYSTEM V INITTAB.
-
-WARNING: USE GNU TAR -- OTHER TARS WILL FAIL SILENTLY!
-
-WARNING: DO *NOT* INSTALL WITHOUT THINKING.
-
-WARNING: Read the util-linux-2.2.bin.Notes file *BEFORE* and *AFTER*
-         installation: there are a few links you must make by hand.
-
-WARNING: The agetty, simpleinit, login, passwd, and other programs in this
-         package are *NOT* System V compliant.  These utilities are meant
-         to be used by people who build their own systems.  If you are not
-         a wizard, do *NOT* blindly install these utilities: they could
-         prevent you from logging into your system.  Have a boot floppy
-         ready, especially if you don't know what you are doing.
-
-WARNING: The binary distribution was tarred using GNU TAR AND THE -S OPTION!
-         This means that holes will be preserved, but that ONLY GNU TAR
-         WILL WORK ON THE BINARY DISTRIBUTION (in fact, other, inferior,
-         tar programs will fail silently).  YOU HAVE BEEN WARNED!
-
-WARNING: localtime and posixtime default to US/Eastern -- change these now.
-
-
-
-To install from the binary distribution:
-
-1) Get binary distribution (see the .lsm file for locations)
-2) cd /
-3) gtar zpxvf util-linux-2.2.bin.tar.gz
-   (or: pms -i util-linux-2.2.bin.tar.gz)
-4) *IF* you want to use agetty and simpleinit, then make softlinks from
-   /sbin/init to simpleinit and from /sbin/getty to agetty, but make sure
-   that your /etc/inittab is set up right (this is *NOT* the System V
-   compatible init!), or you will be hosed.
-5) Run zic -l and/or zic -p to set your timezone.  The distribution is set
-   up to use /usr/lib/zoneinfo/US/Eastern as the default.  This was
-   installed with "zic -l US/Eastern"
-6) Remove all the old binaries from previous locations.
-
-
-
-To install from source:
-
-1) Get source distribution (see the .lsm file for locations)
-2) Untar util-linux-2.2.tar.gz in /usr/src
-3) cd util-linux-2.2
-4) Edit MCONFIG:
-
-   If you use the shadow password suite and do _not_ want to install
-   programs like login and passwd that do not support shadow passwords,
-   then set HAVE_SHADOW to yes
-
-   If you use the System V init suite and do _not_ want to install programs
-   like agetty, simpleinit, and shutdown, then set HAVE_SYSVINIT to yes
-
-   If you don't like the compile-time options or the directories, then
-   change them.  Note that you also can say something like "make OPT=-g
-   LDFLAGS=" in order to make a complete debugging version without editing
-   the MCONFIG at all.
-
-5) make
-6) make install
-7) If you want to use simpleinit and agetty, then make softlinks from
-   /sbin/init to simpleinit and from /sbin/getty to agetty, but make sure
-   that your /etc/inittab is set up right (this is *NOT* the System V
-   compatible init!), or you will be hosed.  If you are using the SysV
-   init and/or some other getty, they you can keep using those.
-8) Run zic -l and/or zic -p to set your timezone.  The distribution is set
-   up to use /usr/lib/zoneinfo/US/Eastern as the default.  This was
-   installed with "zic -l US/Eastern"
-9) Remove all the old binaries from previous locations.
-
-
-
-HIGHLIGHTS for version 2.2:
-1) This is primarily a quick bug-fix release for version 2.1
-2) mkfs wrapper added back in, since e2fsprogs only supplies an fsck wrapper
-3) selection removed, since someone appears to be maintaining it now.  See
-   sunsite.unc.edu:/pub/linux/kernel/patches/console for recent sources.
-   For the time being, I'm keeping a copy in the historic subdirectory of
-   util-linux.  A "make install" should work find from within that
-   directory.
-4) Note that other floppy utilities are available from:
-    ftp.imag.fr:pub/Linux/ZLIBC/fdutils/fdutils-4.1.src.tar.gz
-    sunsite.unc.edu:/pub/Linux/system/Misc/fdutils-4.1.src.tar.gz
-    tsx-11.mit.edu:/pub/linux/sources/sbin/fdutils-4.1.src.tar.gz
-
-
-HIGHLIGHTS for version 2.1:
-
-1) Directory structure rearrange, with configuration support for those who
-   use shadow passwords and System V init (no support is provided for these
-   things, but your utilities won't get overwritten if you do a "make
-   install" after you properly edit MCONFIG).
-2) fdisk and cfdisk should work as expected with 2GB+ disk drives
-3) As usual, lots of stuff was updated and added, including mount, vipw,
-   readprofile
-4) Some stuff was also deleted, and can now be found elsewhere:
-    fsck wrapper: tsx-11.mit.edu:/pub/linux/ALPHA/ext2fs/e2fsprogs*
-    pwd, su: prep.ai.mit.edu:/pub/gnu/sh-utils*
-    ed: prep.ai.mit.edu:/pub/gnu/ed*
-    od: prep.ai.mit.edu:/pub/gnu/textutils*
-    uudecode/uuencode: prep.ai.mit.edu:/pub/gnu/sharutils*
-    bdflush/update: ftp.funet.fi:/pub/OS/Linux/PEOPLE/Linus/v1.1/bdflush*
-
-
-
-PARTIAL HISTORY OF UTIL-LINUX:
-
-bsd:
-    Nothing in this directory gets installed, but some BSD programs need
-    this support:
-        err.c: 8.1 (Berkeley) 6/4/93
-        err.h: 8.1 (Berkeley) 6/2/93
-        getopt.c: 4.13 (Berkeley) 2/23/91
-        pathnames.h: 5.3 (Berkeley) 5/9/89 with extensive modifications for
-                     Linux
-
-disk-utils:
-    cfdisk: 0.8 BETA (>2GB) from Kevin E. Martin (martin@cs.unc.edu) with
-            modifications for disks > 2GB.
-            ftp.cs.unc.edu:/pub/users/martin/linux/cfdisk-0.8.tar.gz
-    fdformat: Werner Almesberger (almesber@nessie.cs.id.ethz.ch), with
-              modifications by Marcel Mol (marcel@dutecad.et.tudelft.nl)).
-              Later, updated with a September 1992 version by Werner.
-    fdisk: A. V. Le Blanc (LeBlanc@mcc.ac.uk) fdisk 1.5 release, with
-           patched from Kevin Martin for DOS and OS/2 compatibility (1.5a);
-           Rik Faith (1.5b, 2.0).
-    frag: Werner Almesberger (1.0), Steffen Zahn (1.1), Rob Hooft (1.2), 
-          Steffen Zahn (szahn%masterix@emndev.siemens.co.at) (1.3), Michael
-          Bischoff <mbi@mo.math.nat.tu-bs.de> (1.4).
-    fsck.minix, mkfs.minix: Linus Torvalds, with modifications by: Rik
-                            Faith (faith@cs.unc.edu), Scott Heavner
-                            (sdh@po.cwru.edu), Dr. Wettstein
-                            (greg%wind.uucp@plains.nodak.edu), Daniel
-                            Quinlan (quinlan@yggdrasil.com).
-    mkswap: Linus Torvalds, with modifications by Mike Jagdis
-            (jaggy@purplet.demon.co.uk. )
-    setfdprm: Werner Almesberger (almesber@nessie.cs.id.ethz.ch)
-              Note that more floppy utilities are available from:
-                ftp.imag.fr:pub/Linux/ZLIBC/fdutils/fdutils-4.1.src.tar.gz
-                sunsite.unc.edu:/pub/Linux/system/Misc/fdutils-4.1.src.tar.gz
-                tsx-11.mit.edu:/pub/linux/sources/sbin/fdutils-4.1.src.tar.gz
-    llseek.c: from Remy Card's e2fsprogs-0.5b-WIP.tar.gz
-
-games:
-    banner: (8.3 (Berkeley) 4/2/94)
-    ddate: Druel the Chaotic aka Jeremy Johnson aka mpython@gnu.ai.mit.edu,
-           with modifications by Lee Harvey Oswald Smith, K.S.C.
-
-login-utils:
-    agetty: W. Z. Venema, ported by Peter Orbaek <poe@daimi.aau.dk>.
-            ftp.daimi.aau.dk:/pub/linux/poe/poeigl-1.32.tar.gz
-    chfn: Salvatore Valente <svalente@athena.mit.edu>
-    chsh: Salvatore Valente <svalente@athena.mit.edu>
-    last: 5.11 w/year (Berkeley) 6/29/88; Port by Michael Haardt with
-          changes by Peter Orbaek.
-          ftp://ftp.daimi.aau.dk/pub/linux/poe/admutil-1.14.tar.gz
-    login: 5.40 (Berkeley) 5/9/89; with ports by Michael Glad and Peter Orbaek
-           ftp.daimi.aau.dk:/pub/linux/poe/poeigl-1.32.tar.gz
-    mesg: Miquel van Smoorenburg (miquels@htsa.aha.nl,
-          miquels@drinkel.nl.mugnet.org).  From his sysvinit.tar.Z package.
-    newgrp: Michael Haardt, with modifications by Peter Orbaek.
-            ftp://ftp.daimi.aau.dk/pub/linux/poe/admutil-1.14.tar.gz
-    passwd: Peter Orbaek, with yp modifications by Alvaro Martinez
-            Echevarria (alvaro@enano.etsit.upm.es)
-            ftp://ftp.daimi.aau.dk/pub/linux/poe/admutil-1.14.tar.gz
-    shutdown: Peter Orbaek, with new modifications by Stephen Tweedie, Rik
-              Faith, and Dave (gentzel@nova.enet.dec.com).
-              ftp://ftp.daimi.aau.dk/pub/linux/poe/admutil-1.14.tar.gz
-    simpleinit: Peter Orbaek
-                ftp.daimi.aau.dk:/pub/linux/poe/poeigl-1.32.tar.gz
-    vipw: 5.16 (Berkeley) 3/3/91, with modifications by Mike Grupenhoff
-          <kashmir@umiacs.UMD.EDU> 
-    wall: 5.14 (Berkeley) 3/2/91 [From the BSD NET-2 (4.3bsd-reno)
-          distribution at wuarchive.wustl.edu:/mirrors/4.3-reno]
-
-makedev-1.4:
-    MAKEDEV-C: David A. Holland (dholland@husc.harvard.edu)
-               This version MODIFIED by Rik Faith (faith@cs.unc.edu)
-               sunsite.unc.edu:/pub/Linux/system/Admin/MAKEDEV-C-1.4.tar.gz
-
-
-misc-utils:
-    cal: 8.4 (Berkeley) 4/2/94, with modifications by Rik Faith and
-         Hein@student.tu-clausthal.de (Jochen Hein).
-         ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-    clear: Rik Faith
-    domainname: Peter Orbaek
-            ftp.daimi.aau.dk:/pub/linux/poe/poeigl-1.32.tar.gz
-    dsplit: David Arnstein (arnstein@netcom.com)
-            gatekeeper.dec.com:/pub/usenet/comp.sources.misc/volume40/dsplit
-    getopt (getoptprog): jhunix.hcf.jhu.edu:
-           /pub/public_domain_software/NetBSD/usr/src/usr.bin/getopt
-    hostid: Mitch DSouza (m.dsouza@mrc-apu.cam.ac.uk)
-            ftp.daimi.aau.dk:/pub/linux/poe/poeigl-1.32.tar.gz
-    hostname/dnsdomainname: Peter Tobias <tobias@server.et-inf.fho-emden.de>
-              This version (1.6) should also be available soon in:
-              nic.funet.fi:/pub/OS/Linux/PEOPLE/Linus/net-source/base/NetKit-A*
-    kill: BSD version, modified by Salvatore Valente <svalente@mit.edu>
-    logger: 8.1 (Berkeley) 6/6/93, with modifications by Rik Faith
-            ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-    look.c: 8.1 (Berkeley) 6/14/93, with modifications by Rik Faith
-            ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-    mcookie: Rik Faith (faith@cs.unc.edu)
-    md5sum: Branki Lankester and Colin Plumb.  The MD5 message-digest
-            algorithm is in the Public Domain.  This implementation
-            calculates message-digest information only, and can NOT be used
-            for encryption.  Therefore it is exportable from the USA.
-            Original sources in the MIT version of PGP 2.6.2.
-    namei: Roger S. Southwick, with modifications by Steve Tell.
-    reset: Rik Faith
-    script: 5.13 (Berkeley) 3/5/91, with modifications by Rick Sladkey
-            (jrs@world.std.com), Harald Koenig
-            (koenig@nova.tat.physik.uni-tuebingen.de).
-    setterm: Gordon Irlam (gordoni@cs.ua.oz.au), with modifications by
-             Peter MacDonald, Mika Liljeberg (liljeber@cs.Helsinki.FI),
-             John Walder (j-walder@uiuc.edu) [for dosemu].
-    tsort: 5.3 (Berkeley) 6/1/90
-           wuarchive.wustl.edu:/mirrors/4.3-reno
-    whereis: 5.5 (Berkeley) 4/18/91
-             wuarchive.wustl.edu:/mirrors/4.3-reno
-    write: 4.22 (Berkeley) 6/1/90, with modifications by Mike Grupenhoff
-           (kashmir@umiacs.umd.edu) .
-           wuarchive.wustl.edu:/mirrors/4.3-reno
-
-mount:
-    mount, umount, swapon
-
-    Rick Sladkey put together the mount-0.99.6.tar.Z package, and Stephen
-    Tweedie provided updates.  The utilities were originally from that
-    package (all appear to be by Doug Quale (quale@saavik.cs.wisc.edu),
-    with modifications by H. J. Lu (hlu@eecs.wsu.edu) on 11/25/92; Rick
-    Sladkey (jrs@world.std.com) in January 1993; and Stephen Tweedie
-    <sct@dcs.ed.ac.uk> on 8 October 1993.  This distribution mount now
-    supports NFS stuff.  I have modified the man pages.  I have also added
-    a small patch from Hamish Glen Coleman (t933093@minyos.xx.rmit.OZ.AU)
-    which restores the -o semantics.
-    
-    Updated with Rick Sladkey's mount-0.99.14.tar.gz package, and with
-    extra patches from Rick.  Adam J. Richter allowed -t option to be
-    optional. Patrick J. Volkerding (volkerdi@mhd1.moorhead.msus.edu) and
-    Mitchum DSouza both provided patches that fixed the (null) problem when
-    not using -t. Mitchum DSouza
-    (mitch@mrc-applied-psychology.cambridge.ac.uk) added support for loop
-    device mounts. Sebastian Lederer
-    (lederer@next-pc.informatik.uni-bonn.de) added support for sending an
-    unmount RPC call to the server when an NFS-filesystem is unmounted.
-    Sander van Malssen (svm@kozmix.hacktic.nl) added support for remounting
-    readonly file systems readonly.  Mike Grupenhoff
-    <kashmir@umiacs.UMD.EDU> added a probe of the superblock for the type
-    before /proc/filesystems is checked.  Andries.Brouwer@cwi.nl fixed up
-    error reporting.
-
-historic/selection: The complete selection-1.5 package, by Andrew Haylett
-    <ajh@gec-mrc.co.uk>, 17th June 1993, is included in the historic tree.
-    Kernel patches are no longer necessary for modern kernels, but these
-    were tiny so I left them in for historical reasons.  The Makefile was
-    modified for this distribution.  With changes from Rick Sladkey.
-
-sys-utils:
-    MAKEDEV: Nick Holloway <Nick.Holloway@alfie.demon.co.uk>
-    arch: Rik Faith <faith@cs.unc.edu>
-    chroot: Rick Sladkey <jrs@world.std.com>
-    clock: Originally from the timesrc-1.2.tar.Z package, Charles Hedrick,
-           hedrick@cs.rutgers.edu (V1.0); Rob Hooft, hooft@chem.ruu.nl
-           (V1.1); Harald Koenig (koenig@nova.tat.physik.uni-tuebingen.de)
-           (V1.2).  With additional changes: Hamish Coleman
-           (hamish@zot.apana.org.au) (V1.2a); Alan Modra
-           (alan@spri.levels.unisa.edu.au (V1.3, V1.4).
-    ctrlaltdel: Peter Orbaek <poe@daimi.aau.dk>
-                ftp://ftp.daimi.aau.dk/pub/linux/poe/admutil-1.14.tar.gz
-    dmesg: Theodore Ts'o (tytso@athena.mit.edu); Rick Sladkey
-           (jrs@world.std.com)
-    ipcrm: From the ipcdelta.tar.z distribution by krishna
-           balasub@cis.ohio-state.edu on 3/15/93.  ipc.info and ipc.texi
-           are also from that distribution.
-    ipcs: Also from the ipcdelta.tar.z distribution by krishna
-          balasub@cis.ohio-state.edu, with patches from Mike Jagdis
-          (jaggy@purplet.demon.co.uk)
-    kbdrate: Rik Faith (faith@cs.unc.edu), with patches from
-             Andries.Brouwer@cwi.nl and John Bowman
-             (bowman@hagar.ph.utexas.edu)
-    lpcntl: Nigel Gamble (nigel@gate.net)
-    rdev: almesber@nessie.cs.id.ethz.ch (Werner Almesberger), with
-          modifications from Peter MacDonald, Stephen Tweedie
-          (sct@dcs.ed.ac.uk), and Dave (gentzel@nova.enet.dec.com)
-    readprofile: Alessandro Rubini
-    renice: 8.1 (Berkeley) 6/9/93
-            ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-    setserial: Michael K. Johnson (johnsonm@stolaf.edu) re-released Rick
-               Sladkey's setserial in January 1993, with changes by
-               Theodore Ts'o (tytso@mit.edu).  I think that Theodore also
-               did extensive changes for version 2.01, I can't find any
-               notes about this in the documentation. However, Theodore
-               Ts'o (tytso@ATHENA.MIT.EDU) released version 2.10, and that
-               is now included.
-    setsid: Rick Sladkey <jrs@world.std.com>
-    sln: Mike Parker and David MacKenzie (from Linux's libc)
-    sync: Nick Holloway, with thanks to James Bonfield
-    tunelp: Michael K. Johnson (johnsonm@nigel.vnet.net)
-    update_state: Rik Faith (faith@cs.unc.edu)
-
-syslogd:
-   5.45 (Berkeley) 3/2/91
-
-   Most of the changes for syslogd come from Rick Sladkey
-   (jrs@world.std.com), but I'd like to thank other people who sent in
-   changes (which usually got forwarded to Rick): Carsten Paeth
-   (calle@calle.in-berlin.de) and Kaz Sasayama (kaz@lilia.iijnet.or.jp).
-
-text-utils:
-    col: 5.3 (Berkeley) 2/2/91; with patches from Andries.Brouwer@cwi.nl
-         and Carl Christofferson (cchris@connected.com)
-         wuarchive.wustl.edu:/mirrors/4.3-reno/{bin,usr.bin}
-    colcrt: 8.1 (Berkeley) 6/6/93 (Bill Joy)
-            ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-    colrm: 5.4 (Berkeley) 6/1/90 (Jeff Schriebman)
-    column: 8.3 (Berkeley) 4/2/94
-            ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-    hexdump: 5.5 (Berkeley) 6/1/90
-             wuarchive.wustl.edu:/mirrors/4.3-reno/{bin,usr.bin}
-    more: 5.19 (Berkeley) 6/29/88 (Eric Shienbrood, Geoff Peck, John Foderaro)
-    rev: 5.2 (Berkeley) 3/21/92; with modifications by Charles Hannum
-         (mycroft@gnu.ai.mit.edu), Brian Koehmstedt (bpk@gnu.ai.mit.edu),
-         bjdouma@xs4all.nl
-         wuarchive.wustl.edu:/mirrors/4.3-reno/{bin,usr.bin}
-    strings: 5.10 (Berkeley) 5/23/91; with patches from Vitor Duarte
-             <vad@fct.unl.pt>
-             wuarchive.wustl.edu:/mirrors/4.3-reno/{bin,usr.bin}
-    ul: 8.1 (Berkeley) 6/6/93
-        ftp.cdrom.com:/pub/bsd-sources/4.4BSD-Lite/usr/src/usr.bin
-
-time:
-    elsie.nci.nih.gov:/pub/classictzcode.tar.gz
-    elsie.nci.nih.gov:/pub/classictzdata.tar.gz
-    (The zoneinfo database was updated Dec 1994.)
-
-%%
-* bin/arch
-* bin/dmesg
-* bin/dnsdomainname
-* bin/domainname
-* bin/hostname
-* bin/kill
-* bin/login
-* bin/more
-* bin/mount
-* bin/setserial
-* bin/sync
-* bin/umount
-* dev/MAKEDEV
-* dev/MAKEDEV-C
-* etc/devinfo
-* etc/makedev.cfg
-* etc/fdprm
-* sbin/agetty
-* sbin/cfdisk
-* sbin/clock
-* sbin/fastboot
-* sbin/fasthalt
-* sbin/fdisk
-* sbin/fsck.minix
-* sbin/halt
-* sbin/kbdrate
-* sbin/mkfs
-* sbin/mkfs.minix
-* sbin/mkswap
-* sbin/reboot
-* sbin/shutdown
-* sbin/simpleinit
-* sbin/sln
-* sbin/swapoff
-* sbin/swapon
-* usr/bin/cal
-* usr/bin/chfn
-* usr/bin/chsh
-* usr/bin/clear
-* usr/bin/col
-* usr/bin/colcrt
-* usr/bin/colrm
-* usr/bin/column
-* usr/bin/dsplit
-* usr/bin/fdformat
-* usr/bin/getopt
-* usr/bin/hexdump
-* usr/bin/hostid
-* usr/bin/ipcrm
-* usr/bin/ipcs
-* usr/bin/last
-* usr/bin/logger
-* usr/bin/look
-* usr/bin/lpcntl
-* usr/bin/mcookie
-* usr/bin/md5sum
-* usr/bin/mesg
-* usr/bin/namei
-* usr/bin/newgrp
-* usr/bin/passwd
-* usr/bin/ramsize
-* usr/bin/rdev
-* usr/bin/readprofile
-* usr/bin/renice
-* usr/bin/reset
-* usr/bin/rev
-* usr/bin/rootflags
-* usr/bin/script
-* usr/bin/setfdprm
-* usr/bin/setsid
-* usr/bin/setterm
-* usr/bin/strings
-* usr/bin/swapdev
-* usr/bin/tsort
-* usr/bin/tunelp
-* usr/bin/ul
-* usr/bin/vidmode
-* usr/bin/wall
-* usr/bin/whereis
-* usr/bin/write
-* usr/info/ipc.info
-* usr/lib/libz.a
-* usr/lib/more.help
-* usr/lib/zoneinfo
-* usr/man/man1/arch.1
-* usr/man/man1/cal.1
-* usr/man/man1/chfn.1
-* usr/man/man1/chsh.1
-* usr/man/man1/clear.1
-* usr/man/man1/col.1
-* usr/man/man1/colcrt.1
-* usr/man/man1/colrm.1
-* usr/man/man1/column.1
-* usr/man/man1/dnsdomainname.1
-* usr/man/man1/domainname.1
-* usr/man/man1/dsplit.1
-* usr/man/man1/getopt.1
-* usr/man/man1/hexdump.1
-* usr/man/man1/hostid.1
-* usr/man/man1/hostname.1
-* usr/man/man1/kill.1
-* usr/man/man1/last.1
-* usr/man/man1/logger.1
-* usr/man/man1/login.1
-* usr/man/man1/look.1
-* usr/man/man1/md5sum.1
-* usr/man/man1/mesg.1
-* usr/man/man1/more.1
-* usr/man/man1/namei.1
-* usr/man/man1/newgrp.1
-* usr/man/man1/passwd.1
-* usr/man/man1/readprofile.1
-* usr/man/man1/reset.1
-* usr/man/man1/rev.1
-* usr/man/man1/script.1
-* usr/man/man1/setterm.1
-* usr/man/man1/strings.1
-* usr/man/man1/tsort.1
-* usr/man/man1/ul.1
-* usr/man/man1/wall.1
-* usr/man/man1/whereis.1
-* usr/man/man1/write.1
-* usr/man/man3/newctime.3
-* usr/man/man3/newtzset.3
-* usr/man/man5/devinfo.5
-* usr/man/man5/fstab.5
-* usr/man/man5/makedev.cfg.5
-* usr/man/man5/nfs.5
-* usr/man/man5/syslog.conf.5
-* usr/man/man5/tzfile.5
-* usr/man/man6/banner.6
-* usr/man/man6/ddate.6
-* usr/man/man8/MAKEDEV-C.8
-* usr/man/man8/MAKEDEV.8
-* usr/man/man8/agetty.8
-* usr/man/man8/cfdisk.8
-* usr/man/man8/chroot.8
-* usr/man/man8/clock.8
-* usr/man/man8/ctrlaltdel.8
-* usr/man/man8/dmesg.8
-* usr/man/man8/fastboot.8
-* usr/man/man8/fasthalt.8
-* usr/man/man8/fdformat.8
-* usr/man/man8/fdisk.8
-* usr/man/man8/frag.8
-* usr/man/man8/fsck.minix.8
-* usr/man/man8/halt.8
-* usr/man/man8/ipcrm.8
-* usr/man/man8/ipcs.8
-* usr/man/man8/kbdrate.8
-* usr/man/man8/lpcntl.8
-* usr/man/man8/mkfs.8
-* usr/man/man8/mkfs.minix.8
-* usr/man/man8/mkswap.8
-* usr/man/man8/mount.8
-* usr/man/man8/ramsize.8
-* usr/man/man8/rdev.8
-* usr/man/man8/reboot.8
-* usr/man/man8/renice.8
-* usr/man/man8/rootflags.8
-* usr/man/man8/setfdprm.8
-* usr/man/man8/setserial.8
-* usr/man/man8/setsid.8
-* usr/man/man8/shutdown.8
-* usr/man/man8/simpleinit.8
-* usr/man/man8/swapdev.8
-* usr/man/man8/swapoff.8
-* usr/man/man8/swapon.8
-* usr/man/man8/sync.8
-* usr/man/man8/syslogd.8
-* usr/man/man8/tunelp.8
-* usr/man/man8/umount.8
-* usr/man/man8/update_state.8
-* usr/man/man8/vidmode.8
-* usr/man/man8/vipw.8
-* usr/man/man8/zdump.8
-* usr/man/man8/zic.8
-* usr/sbin/chroot
-* usr/sbin/ctrlaltdel
-* usr/sbin/frag
-* usr/sbin/syslogd
-* usr/sbin/update_state
-* usr/sbin/vipw
-* usr/sbin/zdump
-* usr/sbin/zic
+
+                                 util-linux
+
+               util-linux is a random collection of Linux utilities
+
+     Note: for the years 2006-2010 this project was named "util-linux-ng".
+
+COMPILE & INSTALL:
+
+      See Documentation/howto-compilation.txt.
+
+MAILING LIST:
+
+      E-MAIL:  util-linux@vger.kernel.org
+      URL:     http://vger.kernel.org/vger-lists.html#util-linux
+      ARCHIVE: https://lore.kernel.org/util-linux/
+
+      The mailing list will reject email messages that contain:
+       - more than 100K characters
+       - html
+       - spam phrases/keywords
+      See: http://vger.kernel.org/majordomo-info.html#taboo
+
+IRC CHANNEL:
+
+      #util-linux at libera.chat:
+
+      irc://irc.libera.chat/util-linux
+
+      The IRC channel and Mailing list are for developers and project
+      maintainers. For end users it is recommended to utilize the
+      distribution's support system.
+
+BUG REPORTING:
+
+      E-MAIL: util-linux@vger.kernel.org
+      Web:    https://github.com/util-linux/util-linux/issues
+
+      Bug reports with sensitive or private information: Karel Zak <kzak@redhat.com>
+
+      This project has no resources to provide support for distribution specific
+      issues. For end users it is recommended to utilize the distribution's
+      support system.
+
+NLS (PO TRANSLATIONS):
+
+      PO files are maintained by:
+         https://translationproject.org/domain/util-linux.html
+
+VERSION SCHEMA:
+
+      Standard releases:
+         <major>.<minor>[.<maint>]
+            major = fatal and deep changes
+            minor = typical release with new features
+            maint = maintenance releases; bug fixes only
+
+      Development releases:
+        <major>.<minor>-rc<N>
+
+SOURCE CODE:
+
+ Download archive:
+         https://www.kernel.org/pub/linux/utils/util-linux/
+
+ See also:
+     Documentation/howto-contribute.txt
+     Documentation/howto-build-sys.txt
+     Documentation/howto-pull-request.txt
+
+ SCM (Source Code Management) Repository:
+
+    Primary repository:
+         git clone git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git
+
+    Backup repository:
+         git clone https://github.com/util-linux/util-linux.git
+
+    Web interfaces:
+         https://git.kernel.org/cgit/utils/util-linux/util-linux.git
+         https://github.com/util-linux/util-linux
+
+      Note: the GitHub repository may contain temporary development branches too.
+
+      The kernel.org repository contains master (current development) and stable/*
+      (maintenance) branches only. All master or stable/* changes are always pushed
+      to both repositories at the same time.
+
+    Repository Branches: 'git branch -a'
+         master branch
+          - current development
+          - the source for stable releases when deemed ready.
+          - day-to-day status is: 'it works for me'. This means that its
+            normal state is useful but not well tested.
+          - long-term development or invasive changes in active development are
+            forked into separate 'topic' branches from the tip of 'master'.
+
+         stable/ branches
+          - public releases
+          - branch name: stable/v<major>.<minor>.
+          - created from the 'master' branch after two or more release
+            candidates and the final public release. This means that the stable
+            releases are committed, tagged, and reachable in 'master'.
+          - these branches then become forked development branches. This means
+            that any changes made to them diverge from the 'master' branch.
+          - maintenance releases are part of, and belong to, their respective
+            stable branch. As such, they are tags(<major>.<minor>.<maint>) and
+            not branches of their own. They are not part of, visible in, or
+            have anything to do with the 'master' development branch. In git
+            terminology: maintenance releases are not reachable from 'master'.
+          - when initially cloned (as with the 'git clone' command given above)
+            these branches are created as 'remote tracking branches' and are
+            only visible by using the -a or -r options to 'git branch'. To
+            create a local branch use the desired tag with this command:
+            'git checkout -b v2.29.2 v2.29.2'
+
+    Tags: 'git tag'
+          - a new tag object is created for every release.
+          - tag name: v<version>.
+          - all tags are signed by the maintainer's PGP key.
+
+    Known Bugs:
+       - don't use tag v2.13.1 (created and published by mistake),
+         use v2.13.1-REAL instead.
+
+WORKFLOW EXAMPLE:
+
+ 1) development (branch: <master>)
+
+ 2) master release (tags: v2.29-rc1, v2.29-rc2, v2.29, branch: <master>)
+
+ 3) development (work on v2.30, branch: <master>)
+
+ 4) fork -- create a new branch <stable/v2.29> based on tag v2.29
+
+     4a) new patches or cherry-pick patches from <master> (branch: <stable/v2.29>)
+
+     4b) stable release (tag: v2.29.1, branch: <stable/v2.29>)
+
+     4c) more patches; another release (tag: v2.29.2, branch: <stable/v2.29>)
+
+ 5) master release v2.30 (branch: <master>)
+    ...
+
+where 3) and 4) happen simultaneously.
+