1UDFINFO(1)                  General Commands Manual                 UDFINFO(1)
2
3
4

NAME

6       udfinfo — show information about UDF filesystem
7
8

SYNOPSIS

10       udfinfo [ options ] device
11
12

DESCRIPTION

14       udfinfo  shows various information about a UDF filesystem stored either
15       on the block device or in the disk file  image.  The  output  from  the
16       udfinfo is suitable for parsing by external applications or scripts.
17
18

OPTIONS

20       -h,--help
21              Display the usage and the list of options.
22
23
24       -b,--blocksize= block-size
25              Specify  the size of blocks in bytes. Valid block size for a UDF
26              filesystem is a power of two in the range from 512 to 32768  and
27              must  match  a device logical (sector) size. If omitted, udfinfo
28              tries to autodetect block size. First it tries logical  (sector)
29              size and then all valid block sizes.
30
31
32       --vatblock= vat-block
33              Specify the block location of the Virtual Allocation Table. Vir‐
34              tual Allocation Table is present only on UDF disks with  Virtual
35              Partition  Map  and  must  be  at the last written/recorded disk
36              block.
37
38              If omitted, udfinfo for optical disc tries to  detect  the  last
39              recorded  block  with fallback to the last block of block device
40              or disk file image. In most cases, this fallback does  not  have
41              to  work  and for disk file images with Virtual Allocation Table
42              is necessary to specify the correct location.
43
44              Virtual Allocation Table contains locations of UDF  disk  blocks
45              needed  to  read  data  storage, determinate used and free space
46              blocks, read File Set Identifier and calculate  Windows-specific
47              Volume  Serial  Number. Also, it contains Logical Volume Identi‐
48              fier and overwrite previously stored in Logical Volume  Descrip‐
49              tor.
50
51
52       --locale
53              Encode  UDF  string  identifiers  on output according to current
54              locale settings (default).
55
56
57       --u8   Encode UDF string identifiers on output to 8-bit OSTA Compressed
58              Unicode  format  without  leading  Compression ID byte, which is
59              equivalent to Latin1 (ISO-8859-1).   This  will  work  only  for
60              strings which Unicode code points are below U+100.
61
62
63       --u16  Encode  UDF  string  identifiers  on  output to 16-bit OSTA Com‐
64              pressed Unicode format  without  leading  Compression  ID  byte,
65              which is equivalent to UTF-16BE.
66
67
68       --utf8 Encode UDF string identifiers on output to UTF-8.
69
70

EXIT STATUS

72       udfinfo  returns 0 if successful, non-zero if there are problems like a
73       block device does not contain UDF filesystem.
74
75

OUTPUT FORMAT

77       First part of the  udfinfo  standard  output  contains  information  in
78       key=value  format.  List of all keys with their meaning are in the fol‐
79       lowing table:
80
81
82              filename         File name of the selected block device or  disk
83                               file image
84
85              label            label  is  an  alias  for lvid, see udflabel(8)
86                               section UDF LABEL AND UUID
87
88              uuid             UUID are first 16 hexadecimal lowercase  digits
89                               of  fullvsid,  but  see udflabel(8) section UDF
90                               LABEL AND UUID
91
92              lvid             UDF Logical Volume  Identifier  stored  in  UDF
93                               Logical Volume Descriptor
94
95              vid              UDF  Volume  Identifier  stored  in UDF Primary
96                               Volume Descriptor
97
98              vsid             fullvsid after uuid  part,  typically  17.–127.
99                               character
100
101              fsid             UDF  File Set Identifier stored in UDF File Set
102                               Descriptor
103
104              fullvsid         UDF Volume Set Identifier stored in UDF Primary
105                               Volume Descriptor
106
107              winserialnum     Windows-specific Volume Serial Number
108
109              blocksize        UDF block size
110
111              blocks           Number  of  all  blocks  on  the selected block
112                               device or disk file image
113
114              usedblocks       Number of used space blocks  on  UDF  disk  for
115                               data storage
116
117              freeblocks       Number  of  free  space  blocks on UDF disk for
118                               data storage
119
120              behindblocks     Number of blocks  which  are  behind  the  last
121                               block used by UDF disk
122
123              numfiles         Number of stored files on UDF disk
124
125              numdirs          Number of stored directories on UDF disk
126
127              udfrev           UDF revision needed for reading UDF disk
128
129              udfwriterev      UDF  revision  needed  for writing or modifying
130                               UDF disk
131
132              vatblock         UDF block location of  the  Virtual  Allocation
133                               Table (visible only when available)
134
135              integrity        UDF   integrity  of  Logical  Volume,  one  of:
136                               opened, closed, unknown
137
138              accesstype       UDF  Access   Type,   one   of:   overwritable,
139                               rewritable,  writeonce,  readonly, pseudo-over‐
140                               writable, unknown
141
142              softwriteprotect Status of UDF SoftWriteProtect flag, either yes
143                               or no (available since udfinfo 2.2)
144
145              hardwriteprotect Status of UDF HardWriteProtect flag, either yes
146                               or no (available since udfinfo 2.2)
147
148       When UDF integrity is not closed it means that the  UDF  disk  was  not
149       properly unmounted, is in an inconsistent state and needs repairing.
150
151       When  either  softwriteprotect or hardwriteprotect flag is set then UDF
152       disk should be treated as read-only.
153
154       All UDF string identifiers are stored on UDF disk in Unicode, therefore
155       they  are  locale  or code page agnostic. Options --locale, --u8, --u16
156       and --utf8 controls how are identifiers encoded on output.
157
158       All newline characters from the UDF string identifiers are removed,  so
159       it  is guaranteed that the newline character is present only as a sepa‐
160       rator.
161
162       Second part of the udfinfo standard output contains list of  UDF  block
163       types stored on device, one per line in the following format:
164
165              start=block-num, blocks=block-count, type=block-type
166
167       With  meaning  that  block-type  starts at UDF block block-num and span
168       block-count blocks on device.
169
170       Windows-specific Volume Serial Number is a non-standard  32-bit  check‐
171       sum,  calculated as four separate 8-bit XOR checksums of 512 bytes long
172       UDF File Set Descriptor. Therefore, it cannot  be  set  or  changed  as
173       opposed  to  UUID  which  is 64-bit long. This non-standard checksum is
174       used only by Windows systems (since Windows 98 era when it  was  intro‐
175       duced)  and  can  be  displayed on Windows systems by applications like
176       vol, dir or fsutil.exe.
177
178

LIMITATIONS

180       udfinfo prior to version 2.2 was unable to print Unicode  strings  with
181       code points above U+FFFF correctly.
182
183       udfinfo  prior  to  version  2.2 was unable to read Metadata Partition.
184       Therefore, determining used and free space  blocks,  reading  File  Set
185       Identifier  and  calculating  Windows-specific Volume Serial Number did
186       not have to be available or correctly calculated  for  disks  with  UDF
187       revisions higher than 2.01 which had Metadata Partition.
188
189       udfinfo  prior to version 2.1 was unable to read Virtual Allocation Ta‐
190       ble stored outside of Information Control Block. Therefore above  limi‐
191       tation applied also for some Write Once media.
192
193

AUTHOR

195       Pali Rohár <pali.rohar@gmail.com>
196
197

AVAILABILITY

199       udfinfo is part of the udftools package since version 2.0 and is avail‐
200       able from https://github.com/pali/udftools/.
201
202

SEE ALSO

204       mkudffs(8), pktsetup(8), udflabel(8), cdrwtool(1), wrudf(1)
205
206
207
208Commands                           udftools                         UDFINFO(1)
Impressum