lsmtd.8 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112
  1. .TH LSMTD 8 "April 2017" "mtd-utils"
  2. .SH NAME
  3. lsmtd \- list memory technology devices
  4. .SH SYNOPSIS
  5. .B lsmtd
  6. [options]
  7. .RI [ device ...]
  8. .SH DESCRIPTION
  9. .B lsmtd
  10. lists information about all available or the specified MTD and UBI devices.
  11. The
  12. .B lsmtd
  13. command reads the
  14. .B sysfs
  15. filesystem to gather information. Alternatively, the
  16. .B procfs
  17. filesystem and ioctl interfaces are used, should the sysfs filesytem not
  18. be available.
  19. .PP
  20. The command prints all MTD and UBI devices in a pretty-printed list format by
  21. default.
  22. .PP
  23. The default output is subject to change. So whenever possible, you should
  24. avoid using default outputs in your scripts. Always explicitly define expected
  25. columns by using
  26. .B \-\-output
  27. .I columns-list
  28. in environments where a stable output is required.
  29. .PP
  30. Use
  31. .B "lsmtd --help"
  32. to get a list of all available columns.
  33. .SH OPTIONS
  34. .TP
  35. .BR \-b , " \-\-bytes"
  36. Print columns with size quantities (e.g. erase block size) in bytes instead
  37. of a human-readable format.
  38. .TP
  39. .BR \-h , " \-\-help"
  40. Display a help text and exit.
  41. .TP
  42. .BR \-i , " \-\-ascii"
  43. Only use ascii characters for pretty printing.
  44. .TP
  45. .BR \-J , " \-\-json"
  46. Use JSON output format. All potentially unsafe characters in string values are
  47. escaped with JSON escape sequences or hex-escaped (\\u<code>).
  48. .TP
  49. .BR \-l , " \-\-list"
  50. Use a pretty-printed list output format (default).
  51. .TP
  52. .BR \-m , " \-\-no-ubi"
  53. Do not display information about UBI devices or volumes.
  54. .TP
  55. .BR \-n , " \-\-noheadings"
  56. Do not print column headings when using raw or list output format.
  57. .TP
  58. .BR \-o , " \-\-output " \fIlist\fP
  59. Specify which output columns to print. Use
  60. .B \-\-help
  61. to get a list of all supported columns.
  62. The default list of columns may be extended if \fIlist\fP is
  63. specified in the format \fI+list\fP (e.g. \fBlsmtd -o +EB-SIZE\fP).
  64. .TP
  65. .BR \-O , " \-\-output\-all "
  66. Output all available columns.
  67. .TP
  68. .BR \-P , " \-\-pairs"
  69. Produce output in the form of key="value" pairs.
  70. All potentially unsafe characters are hex-escaped (\\x<code>).
  71. .TP
  72. .BR \-r , " \-\-raw"
  73. Produce output in raw format. All potentially unsafe characters are
  74. hex-escaped (\\x<code>).
  75. .TP
  76. .BR \-u , " \-\-si\-units"
  77. Display human readable sizes as powers of ten rather than powers of two.
  78. .TP
  79. .BR \-V , " \-\-version"
  80. Print version information and exit.
  81. .TP
  82. .BR \-x , " \-\-sort " \fIcolumn\fP
  83. Sort output lines by \fIcolumn\fP.
  84. .SH NOTES
  85. If the
  86. .B \-\-bytes
  87. option is not specified, the JSON output format prints sizes as string values
  88. even if they do not have a suffix.
  89. .SH AUTHORS
  90. .nf
  91. David Oberhollenzer <david.oberhollenzer@sigma-star.at>
  92. .fi
  93. .SH REPORTING BUGS
  94. Report mtd-utils bugs to the Linux mtd mailing list.
  95. .TP
  96. Linux mtd mailing list: <linux-mtd@lists.infradead.org>
  97. .TP
  98. Linux mtd home page: <http://www.linux-mtd.infradead.org/>
  99. .SH AVAILABILITY
  100. The lsmtd command is part of the mtd-utils package and is available from
  101. ftp://ftp.infradead.org/pub/mtd-utils/.
  102. .SH COPYRIGHT
  103. Copyright \(co 2017 David Oberhollenzer - sigma star gmbh
  104. .br
  105. License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl2.html>.
  106. .br
  107. This is free software: you are free to change and redistribute it.
  108. There is NO WARRANTY, to the extent permitted by law.
  109. .SH SEE ALSO
  110. .BR lsblk (8),
  111. .BR ls (1)