logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

rdsquashfs.1 (3329B)


  1. .TH RDSQUASHFS "1" "May 2019" "inspect SquashFS filesystems" "User Commands"
  2. .SH NAME
  3. rdsquashfs \- tool to examine or uncompress SquashFS filesystems
  4. .SH SYNOPSIS
  5. .B rdsquashfs
  6. [\fI\,OPTIONS\/\fR] \fI\,<squashfs-file>\/\fR
  7. .SH DESCRIPTION
  8. View or extract the contents of a squashfs image.
  9. .PP
  10. The following options can be used to specify what operation to perform. One
  11. of those has to be present:
  12. .TP
  13. \fB\-\-list\fR, \fB\-l\fR <path>
  14. Produce a directory listing similar to \fBls \-l\fR for a given path in
  15. the SquashFS image.
  16. .TP
  17. \fB\-\-cat\fR, \fB\-c\fR <path>
  18. If the specified path is a regular file in the image, extract it and dump
  19. its contents to stdout.
  20. .TP
  21. \fB\-\-xattr\fR, \fB\-x\fR <path>
  22. If the inode that the specified path resolves to has extended attributes, dump
  23. them as key value pairs to stdout.
  24. .TP
  25. \fB\-\-unpack\-path\fR, \fB\-u\fR <path>
  26. Unpack the specified sub directory from the image. To unpack everything,
  27. simply specify /.
  28. .TP
  29. \fB\-\-describe\fR, \fB\-d\fR
  30. Produce a file listing from the image compatible with the format consumed by
  31. gensquashfs.
  32. .TP
  33. \fB\-\-stat\fR, \fB\-s\fR <path>
  34. Dump all available information about the inode that the path refers to,
  35. including SquashFS specific internals such as the on-disk layout of a file
  36. or the fast lookup index stored in an extended directory inode.
  37. .PP
  38. The following options can be used to control the behaviour of the specified
  39. operation:
  40. .TP
  41. \fB\-\-unpack\-root\fR, \fB\-p\fR <path>
  42. If used with \fB\-\-unpack\-path\fR, this is where the
  43. data is unpacked to. If used with \fB\-\-describe\fR, this
  44. is used as a prefix for the input path of
  45. regular files.
  46. .TP
  47. \fB\-\-no\-dev\fR, \fB\-D\fR
  48. Skip device special files when parsing the filesystem tree.
  49. .TP
  50. \fB\-\-no\-sock\fR, \fB\-S\fR
  51. Skip socket files when parsing the filesystem tree.
  52. .TP
  53. \fB\-\-no\-fifo\fR, \fB\-F\fR
  54. Skip named pipes when parsing the filesystem tree.
  55. .TP
  56. \fB\-\-no\-slink\fR, \fB\-L\fR
  57. Skip symbolic links when parsing the filesystem tree.
  58. .TP
  59. \fB\-\-no\-empty\-dir\fR, \fB\-E\fR
  60. Skip empty directories, including ones that are empty after applying
  61. the above rules.
  62. .PP
  63. The following options are specific to unpacking files from a SquashFS image
  64. to disk:
  65. .TP
  66. \fB\-\-no\-sparse\fR, \fB\-Z\fR
  67. Do not create sparse files. Always unpack sparse files by
  68. writing blocks of zeros to disk.
  69. .TP
  70. \fB\-\-set\-xattr\fR, \fB\-X\fR
  71. Set the extended attributes from the SquashFS image.
  72. .TP
  73. \fB\-\-set\-times\fR, \fB\-T\fR
  74. Set the create and modify timestamps of the file to the mtime
  75. from the SquashFS image.
  76. .TP
  77. \fB\-\-chmod\fR, \fB\-C\fR
  78. Change permission flags of unpacked files to
  79. those stored in the SquashFS image.
  80. .TP
  81. \fB\-\-chown\fR, \fB\-O\fR
  82. Change ownership of unpacked files to the
  83. UID/GID set in the SquashFS image.
  84. .TP
  85. \fB\-\-quiet\fR, \fB\-q\fR
  86. Do not print out progress while unpacking.
  87. .PP
  88. Other options:
  89. .TP
  90. \fB\-\-help\fR, \fB\-h\fR
  91. Print help text and exit.
  92. .TP
  93. \fB\-\-version\fR, \fB\-V\fR
  94. Print version information and exit.
  95. .SH SEE ALSO
  96. gensquashfs(1), sqfs2tar(1), sqfsdiff(1)
  97. .SH AUTHOR
  98. Written by David Oberhollenzer.
  99. .SH COPYRIGHT
  100. Copyright \(co 2019 David Oberhollenzer
  101. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
  102. .br
  103. This is free software: you are free to change and redistribute it.
  104. There is NO WARRANTY, to the extent permitted by law.