Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0 |
| 2 | |
| 3 | =============== |
| 4 | UDF file system |
| 5 | =============== |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 6 | |
| 7 | If you encounter problems with reading UDF discs using this driver, |
Jan Kara | 503c311 | 2017-10-16 11:55:52 +0200 | [diff] [blame] | 8 | please report them according to MAINTAINERS file. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 9 | |
Phillip Susi | 55aa601 | 2006-11-16 01:19:23 -0800 | [diff] [blame] | 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. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 21 | |
| 22 | ------------------------------------------------------------------------------- |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 23 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 24 | The following mount options are supported: |
| 25 | |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 26 | =========== ====================================== |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 27 | gid= Set the default group. |
| 28 | umask= Set the default umask. |
Marcin Slusarz | 7ac9bcd5 | 2008-11-16 20:52:19 +0100 | [diff] [blame] | 29 | mode= Set the default file permissions. |
| 30 | dmode= Set the default directory permissions. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 41 | =========== ====================================== |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 42 | |
Phillip Susi | 0e6b3e5 | 2006-03-25 03:08:14 -0800 | [diff] [blame] | 43 | The uid= and gid= options need a bit more explaining. They will accept a |
Jan Kara | 6ccd519 | 2018-02-22 10:52:34 +0100 | [diff] [blame] | 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 . |
Phillip Susi | 0e6b3e5 | 2006-03-25 03:08:14 -0800 | [diff] [blame] | 48 | |
Jan Kara | 6ccd519 | 2018-02-22 10:52:34 +0100 | [diff] [blame] | 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. |
Phillip Susi | 0e6b3e5 | 2006-03-25 03:08:14 -0800 | [diff] [blame] | 52 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 53 | The remaining are for debugging and disaster recovery: |
| 54 | |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 55 | ===== ================================ |
| 56 | novrs Skip volume sequence recognition |
| 57 | ===== ================================ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 58 | |
| 59 | The following expect a offset from 0. |
| 60 | |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 61 | ========== ================================================= |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 62 | session= Set the CDROM session (default= last session) |
| 63 | anchor= Override standard anchor location. (default= 256) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 64 | lastblock= Set the last block of the filesystem/ |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 65 | ========== ================================================= |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 66 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 67 | ------------------------------------------------------------------------------- |
| 68 | |
| 69 | |
| 70 | For the latest version and toolset see: |
Jan Kara | 503c311 | 2017-10-16 11:55:52 +0200 | [diff] [blame] | 71 | https://github.com/pali/udftools |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 72 | |
| 73 | Documentation on UDF and ECMA 167 is available FREE from: |
Mauro Carvalho Chehab | c9817ad | 2020-02-17 17:12:29 +0100 | [diff] [blame] | 74 | - http://www.osta.org/ |
Alexander A. Klimov | 248727a | 2020-07-13 22:07:38 +0200 | [diff] [blame] | 75 | - https://www.ecma-international.org/ |