summaryrefslogtreecommitdiffstats
path: root/Documentation/deprecated.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/deprecated.txt')
-rw-r--r--Documentation/deprecated.txt117
1 files changed, 117 insertions, 0 deletions
diff --git a/Documentation/deprecated.txt b/Documentation/deprecated.txt
new file mode 100644
index 0000000..08ba8b9
--- /dev/null
+++ b/Documentation/deprecated.txt
@@ -0,0 +1,117 @@
+The following is a list of commands or features that are deprecated. All
+deprecated utils are in maintenance mode and we keep them in source tree for
+backward compatibility only.
+
+what: hwclock --debug
+why: renamed to --verbose, and may be repurposed later.
+since: v2.32
+
+--------------------------
+
+what: hwclock -v for version
+why: renamed to -V
+since: v2.20 (was repurposed to verbose in v2.32)
+
+--------------------------
+
+what: column --columns
+why: renamed to --output-width
+since: v2.30
+
+--------------------------
+
+what: sfdisk --show-size
+why: this does not belong to fdisk, use "blockdev --getsz"
+
+--------------------------
+
+what: sfdisk --Linux
+why: unnecessary option, only Linux (non-DOS mode) is supported
+
+--------------------------
+
+what: sfdisk --unit
+why: unnecessary option, only 'S'ector unit is supported
+
+--------------------------
+
+what: sfdisk --show-pt-geometry
+why: equal to --show-geometry for a long time
+
+--------------------------
+
+what: "swapon --summary" output format
+why: does not provide control on output data formatting. The recommended solution
+ is to use --show=<columns> in all scripts.
+
+--------------------------
+
+What: mkfs
+Why: use filesystem specific mkfs.<type>.
+
+--------------------------
+
+What: fdisk -s <device>
+Why: this does not belong to fdisk, use "blockdev --getsz"
+
+--------------------------
+
+What: 'udev' and 'list' blkid(8) output formats
+Why: udevd links libblkid directly; the 'list' is unnecessary, use lsblk(8)
+
+--------------------------
+
+What: line(1) command
+Why: use the read(1) command
+
+--------------------------
+
+What: pg(1) command
+Why: use less(1) or more(1)
+
+--------------------------
+
+What: CHS stuff in fdisk (except SUN where are partitions addresses by cylinders only)
+Why: use addressing by sectors, CHS does not work with modern disks,
+ confusing for users...
+
+--------------------------
+
+What: losetup -s
+Why: the option -s is in collision with the Loop-AES losetup dialect that is used
+ in some distributions. Use the long version (--show) only.
+
+--------------------------
+
+What: losetup output format without --list
+
+ deprecated format:
+
+ # losetup -a
+ /dev/loop0: []: (/home/fs-images/swap.img)
+ /dev/loop1: []: (/home/fs-images/disk.img), offset 100
+
+ new format:
+
+ # losetup
+ NAME SIZELIMIT OFFSET AUTOCLEAR RO BACK-FILE
+ /dev/loop0 0 0 0 0 /home/fs-images/swap.img
+ /dev/loop1 0 100 0 0 /home/fs-images/disk.img
+
+--------------------------
+
+What: tunelp
+Why: parallel port printers are probably almost extinct devices
+
+----------------------------
+
+The Single UNIX(TM) Specification, Version 2
+Copyright (C) 1997 The Open Group
+
+ Legacy utilities which are part util-linux package are:
+
+ col
+ line
+ pg
+
+ http://pubs.opengroup.org/onlinepubs/7908799/xcu/intro.html#tag_001_003_003