docs: mark udev and list blkid(8) output formats deprecated

Signed-off-by: Karel Zak <kzak@redhat.com>
This commit is contained in:
Karel Zak 2012-03-26 13:09:27 +02:00
parent b24b8e296e
commit 24d741d88a
3 changed files with 14 additions and 6 deletions

View File

@ -2,6 +2,11 @@ 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: 'udev' and 'list' blkid(8) output formats
Why: udevd links libblkid directly; the 'list' is unnecessary, use lsblk(8)
--------------------------
What: line(1) command
Why: useless, nobody uses this command, head(1) is better

View File

@ -156,7 +156,10 @@ print the value of the tags
.TP
.B list
print the devices in a user-friendly format; this output format is unsupported
for low-level probing (\fB-p\fR or \fB-i\fR)
for low-level probing (\fB-p\fR or \fB-i\fR). This output format is \fBDEPRECATED\fR
in favour of
.BR lsblk (8)
command.
.TP
.B device
print the device name only; this output format is always enabled for \fB-L\fR
@ -168,7 +171,7 @@ prefixed by ID_FS_ or ID_PART_ prefixes
The udev output returns the ID_FS_AMBIVALENT tag if more superblocks are detected,
and ID_PART_ENTRY_* tags are always returned for all partitions including empty
partitions.
partitions. This output format is \fBDEPRECATED\fR.
.TP
.B export
print key=value pairs for easy import into the environment; this output format

View File

@ -31,8 +31,8 @@ extern int optind;
#define OUTPUT_VALUE_ONLY (1 << 1)
#define OUTPUT_DEVICE_ONLY (1 << 2)
#define OUTPUT_PRETTY_LIST (1 << 3)
#define OUTPUT_UDEV_LIST (1 << 4)
#define OUTPUT_PRETTY_LIST (1 << 3) /* deprecated */
#define OUTPUT_UDEV_LIST (1 << 4) /* deprecated */
#define OUTPUT_EXPORT_LIST (1 << 5)
#define LOWPROBE_TOPOLOGY (1 << 1)
@ -73,7 +73,7 @@ static void usage(int error)
" -h print this usage message and exit\n"
" -g garbage collect the blkid cache\n"
" -o <format> output format; can be one of:\n"
" value, device, list, udev, export or full; (default: full)\n"
" value, device, export or full; (default: full)\n"
" -k list all known filesystems/RAIDs and exit\n"
" -s <tag> show specified tag(s) (default show all tags)\n"
" -t <token> find device with a specific token (NAME=value pair)\n"
@ -749,7 +749,7 @@ int main(int argc, char **argv)
else if (!strcmp(optarg, "device"))
output_format = OUTPUT_DEVICE_ONLY;
else if (!strcmp(optarg, "list"))
output_format = OUTPUT_PRETTY_LIST;
output_format = OUTPUT_PRETTY_LIST; /* deprecated */
else if (!strcmp(optarg, "udev"))
output_format = OUTPUT_UDEV_LIST;
else if (!strcmp(optarg, "export"))