summaryrefslogtreecommitdiffstats
path: root/disk-utils/isosize.8
diff options
context:
space:
mode:
Diffstat (limited to 'disk-utils/isosize.8')
-rw-r--r--disk-utils/isosize.855
1 files changed, 55 insertions, 0 deletions
diff --git a/disk-utils/isosize.8 b/disk-utils/isosize.8
new file mode 100644
index 0000000..8d58993
--- /dev/null
+++ b/disk-utils/isosize.8
@@ -0,0 +1,55 @@
+.TH ISOSIZE 8 "June 2011" "util-linux" "System Administration"
+.SH NAME
+isosize \- output the length of an iso9660 filesystem
+.SH SYNOPSIS
+.B isosize
+.RI [options] " iso9660_image_file"
+.SH DESCRIPTION
+This command outputs the length of an iso9660 filesystem that
+is contained in the specified file. This file may be a normal file or
+a block device (e.g.\& /dev/hdd or /dev/sr0). In the absence of
+any options (and errors), it will output the size of the iso9660
+filesystem in bytes. This can now be a large number (>> 4\ GB).
+.SH OPTIONS
+.TP
+.BR \-x , " \-\-sectors"
+Show the block count and block size in human-readable form.
+The output uses the term "sectors" for "blocks".
+.TP
+.BR \-d , " \-\-divisor " \fInumber\fR
+Only has an effect when
+.B \-x
+is not given. The value shown (if no errors)
+is the iso9660 file size in bytes divided by
+.IR number .
+So if
+.I number
+is the block size then the shown value will be the block count.
+.PP
+The size of the file (or block device) holding an iso9660
+filesystem can be marginally larger than the actual size of the
+iso9660 filesystem. One reason for this is that cd writers
+are allowed to add "run out" sectors at the end of an iso9660
+image.
+.SH EXIT STATUS
+.RS
+.PD 0
+.TP
+.B 0
+success
+.TP
+.B 1
+generic failure, such as invalid usage
+.TP
+.B 32
+all failed
+.TP
+.B 64
+some failed
+.PD
+.RE
+.SH AVAILABILITY
+The isosize command is part of the util-linux package and is available from
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+Linux Kernel Archive
+.UE .