^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) UDF file system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) If you encounter problems with reading UDF discs using this driver,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) please report them according to MAINTAINERS file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Write support requires a block driver which supports writing. Currently
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) dvd+rw drives and media support true random sector writes, and so a udf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) filesystem on such devices can be directly mounted read/write. CD-RW
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) media however, does not support this. Instead the media can be formatted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) for packet mode using the utility cdrwtool, then the pktcdvd driver can
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) be bound to the underlying cd device to provide the required buffering
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) and read-modify-write cycles to allow the filesystem random sector writes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) while providing the hardware with only full packet writes. While not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) required for dvd+rw media, use of the pktcdvd driver often enhances
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) performance due to very poor read-modify-write support supplied internally
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) by drive firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) -------------------------------------------------------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) The following mount options are supported:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) =========== ======================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) gid= Set the default group.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) umask= Set the default umask.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) mode= Set the default file permissions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) dmode= Set the default directory permissions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) uid= Set the default user.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) bs= Set the block size.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) unhide Show otherwise hidden files.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) undelete Show deleted files in lists.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) adinicb Embed data in the inode (default)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) noadinicb Don't embed data in the inode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) shortad Use short ad's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) longad Use long ad's (default)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) nostrict Unset strict conformance
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) iocharset= Set the NLS character set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) =========== ======================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) The uid= and gid= options need a bit more explaining. They will accept a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) decimal numeric value and all inodes on that mount will then appear as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) belonging to that uid and gid. Mount options also accept the string "forget".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) The forget option causes all IDs to be written to disk as -1 which is a way
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) of UDF standard to indicate that IDs are not supported for these files .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) For typical desktop use of removable media, you should set the ID to that of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) the interactively logged on user, and also specify the forget option. This way
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) the interactive user will always see the files on the disk as belonging to him.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) The remaining are for debugging and disaster recovery:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) ===== ================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) novrs Skip volume sequence recognition
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) ===== ================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) The following expect a offset from 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) ========== =================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) session= Set the CDROM session (default= last session)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) anchor= Override standard anchor location. (default= 256)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) lastblock= Set the last block of the filesystem/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) ========== =================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) -------------------------------------------------------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) For the latest version and toolset see:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) https://github.com/pali/udftools
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) Documentation on UDF and ECMA 167 is available FREE from:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) - http://www.osta.org/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - https://www.ecma-international.org/