Documentation/deprecated.txt

   1 The following is a list of commands or features that are deprecated.  All
   2 deprecated utils are in maintenance mode and we keep them in source tree for
   3 backward compatibility only.
   4
   5
   6 what:  column --table-empty-lines
   7 why:   renamed to --keep-empty-lines
   8 since: v2.37
   9
  10 --------------------------
  11
  12 what:  hwclock --debug
  13 why:   renamed to --verbose, and may be repurposed later.
  14 since: v2.32
  15
  16 --------------------------
  17
  18 what:  hwclock -v for version
  19 why:   renamed to -V
  20 since: v2.20 (was repurposed to verbose in v2.32)
  21
  22 --------------------------
  23
  24 what:  column --columns
  25 why:   renamed to --output-width
  26 since: v2.30
  27
  28 --------------------------
  29
  30 what:  sfdisk --show-size
  31 why:   this does not belong to fdisk, use "blockdev --getsz"
  32
  33 --------------------------
  34
  35 what:   sfdisk --Linux
  36 why:    unnecessary option, only Linux (non-DOS mode) is supported
  37
  38 --------------------------
  39
  40 what:   sfdisk --unit
  41 why:    unnecessary option, only 'S'ector unit is supported
  42
  43 --------------------------
  44
  45 what:   sfdisk --show-pt-geometry
  46 why:    equal to --show-geometry for a long time
  47
  48 --------------------------
  49
  50 what:  "swapon --summary" output format
  51 why:   does not provide control on output data formatting. The recommended solution
  52        is to use --show=<columns> in all scripts.
  53
  54 --------------------------
  55
  56 What:   mkfs
  57 Why:    use filesystem specific mkfs.<type>.
  58
  59 --------------------------
  60
  61 What:   fdisk -s <device>
  62 Why:    this does not belong to fdisk, use "blockdev --getsz"
  63
  64 --------------------------
  65
  66 What:   'udev' and 'list' blkid(8) output formats
  67 Why:    udevd links libblkid directly; the 'list' is unnecessary, use lsblk(8)
  68
  69 --------------------------
  70
  71 What:   line(1) command
  72 Why:    use the read(1) command
  73
  74 --------------------------
  75
  76 What:   pg(1) command
  77 Why:    use less(1) or more(1)
  78
  79 --------------------------
  80
  81 What:   CHS stuff in fdisk (except SUN where are partitions addresses by cylinders only)
  82 Why:    use addressing by sectors, CHS does not work with modern disks,
  83         confusing for users...
  84
  85 --------------------------
  86
  87 What:   losetup -s
  88 Why:    the option -s is in collision with the Loop-AES losetup dialect that is used
  89         in some distributions. Use the long version (--show) only.
  90
  91 --------------------------
  92
  93 What:   losetup output format without --list
  94
  95         deprecated format:
  96
  97           # losetup -a
  98           /dev/loop0: []: (/home/fs-images/swap.img)
  99           /dev/loop1: []: (/home/fs-images/disk.img), offset 100
 100
 101         new format:
 102
 103           # losetup
 104           NAME       SIZELIMIT OFFSET AUTOCLEAR RO BACK-FILE
 105           /dev/loop0         0      0         0  0 /home/fs-images/swap.img
 106           /dev/loop1         0    100         0  0 /home/fs-images/disk.img
 107
 108 --------------------------
 109
 110 What:   tunelp
 111 Why:    parallel port printers are probably almost extinct devices
 112
 113 ----------------------------
 114
 115 The Single UNIX(TM) Specification, Version 2
 116 Copyright (C) 1997 The Open Group
 117
 118   Legacy utilities which are part util-linux package are:
 119
 120         col
 121         line
 122         pg
 123
 124   https://pubs.opengroup.org/onlinepubs/7908799/xcu/intro.html#tag_001_003_003