Documentation/filesystems/udf.rst

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