blob: cf30bdcdcc4f5ef579609b9eb28d146af1f20267 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001*
2* Documentation/filesystems/udf.txt
3*
Linus Torvalds1da177e2005-04-16 15:20:36 -07004
5If you encounter problems with reading UDF discs using this driver,
Jan Kara503c3112017-10-16 11:55:52 +02006please report them according to MAINTAINERS file.
Linus Torvalds1da177e2005-04-16 15:20:36 -07007
Phillip Susi55aa6012006-11-16 01:19:23 -08008Write support requires a block driver which supports writing. Currently
9dvd+rw drives and media support true random sector writes, and so a udf
10filesystem on such devices can be directly mounted read/write. CD-RW
11media however, does not support this. Instead the media can be formatted
12for packet mode using the utility cdrwtool, then the pktcdvd driver can
13be bound to the underlying cd device to provide the required buffering
14and read-modify-write cycles to allow the filesystem random sector writes
15while providing the hardware with only full packet writes. While not
16required for dvd+rw media, use of the pktcdvd driver often enhances
17performance due to very poor read-modify-write support supplied internally
18by drive firmware.
Linus Torvalds1da177e2005-04-16 15:20:36 -070019
20-------------------------------------------------------------------------------
21The following mount options are supported:
22
23 gid= Set the default group.
24 umask= Set the default umask.
Marcin Slusarz7ac9bcd52008-11-16 20:52:19 +010025 mode= Set the default file permissions.
26 dmode= Set the default directory permissions.
Linus Torvalds1da177e2005-04-16 15:20:36 -070027 uid= Set the default user.
28 bs= Set the block size.
29 unhide Show otherwise hidden files.
30 undelete Show deleted files in lists.
31 adinicb Embed data in the inode (default)
32 noadinicb Don't embed data in the inode
33 shortad Use short ad's
34 longad Use long ad's (default)
35 nostrict Unset strict conformance
36 iocharset= Set the NLS character set
37
Phillip Susi0e6b3e52006-03-25 03:08:14 -080038The uid= and gid= options need a bit more explaining. They will accept a
Jan Kara6ccd5192018-02-22 10:52:34 +010039decimal numeric value and all inodes on that mount will then appear as
40belonging to that uid and gid. Mount options also accept the string "forget".
41The forget option causes all IDs to be written to disk as -1 which is a way
42of UDF standard to indicate that IDs are not supported for these files .
Phillip Susi0e6b3e52006-03-25 03:08:14 -080043
Jan Kara6ccd5192018-02-22 10:52:34 +010044For typical desktop use of removable media, you should set the ID to that of
45the interactively logged on user, and also specify the forget option. This way
46the interactive user will always see the files on the disk as belonging to him.
Phillip Susi0e6b3e52006-03-25 03:08:14 -080047
Linus Torvalds1da177e2005-04-16 15:20:36 -070048The remaining are for debugging and disaster recovery:
49
50 novrs Skip volume sequence recognition
51
52The following expect a offset from 0.
53
54 session= Set the CDROM session (default= last session)
55 anchor= Override standard anchor location. (default= 256)
56 volume= Override the VolumeDesc location. (unused)
57 partition= Override the PartitionDesc location. (unused)
58 lastblock= Set the last block of the filesystem/
59
60The following expect a offset from the partition root.
61
62 fileset= Override the fileset block location. (unused)
63 rootdir= Override the root directory location. (unused)
64 WARNING: overriding the rootdir to a non-directory may
65 yield highly unpredictable results.
66-------------------------------------------------------------------------------
67
68
69For the latest version and toolset see:
Jan Kara503c3112017-10-16 11:55:52 +020070 https://github.com/pali/udftools
Linus Torvalds1da177e2005-04-16 15:20:36 -070071
72Documentation on UDF and ECMA 167 is available FREE from:
73 http://www.osta.org/
74 http://www.ecma-international.org/