[PATCH] udf: fix uid/gid options and add uid/gid=ignore and forget options
[linux-2.6.git] / Documentation / filesystems / udf.txt
1 *
2 * Documentation/filesystems/udf.txt
3 *
4 UDF Filesystem version 0.9.8.1
5
6 If you encounter problems with reading UDF discs using this driver,
7 please report them to linux_udf@hpesjro.fc.hp.com, which is the
8 developer's list.
9
10 Write support requires a block driver which supports writing. The current
11 scsi and ide cdrom drivers do not support writing.
12
13 -------------------------------------------------------------------------------
14 The following mount options are supported:
15
16         gid=            Set the default group.
17         umask=          Set the default umask.
18         uid=            Set the default user.
19         bs=             Set the block size.
20         unhide          Show otherwise hidden files.
21         undelete        Show deleted files in lists.
22         adinicb         Embed data in the inode (default)
23         noadinicb       Don't embed data in the inode
24         shortad         Use short ad's
25         longad          Use long ad's (default)
26         nostrict        Unset strict conformance
27         iocharset=      Set the NLS character set
28
29 The uid= and gid= options need a bit more explaining.  They will accept a
30 decimal numeric value which will be used as the default ID for that mount.
31 They will also accept the string "ignore" and "forget".  For files on the disk
32 that are owned by nobody ( -1 ), they will instead look as if they are owned
33 by the default ID.  The ignore option causes the default ID to override all
34 IDs on the disk, not just -1.  The forget option causes all IDs to be written
35 to disk as -1, so when the media is later remounted, they will appear to be
36 owned by whatever default ID it is mounted with at that time.
37
38 For typical desktop use of removable media, you should set the ID to that
39 of the interactively logged on user, and also specify both the forget and
40 ignore options.  This way the interactive user will always see the files
41 on the disk as belonging to him.
42
43 The remaining are for debugging and disaster recovery:
44
45         novrs           Skip volume sequence recognition 
46
47 The following expect a offset from 0.
48
49         session=        Set the CDROM session (default= last session)
50         anchor=         Override standard anchor location. (default= 256)
51         volume=         Override the VolumeDesc location. (unused)
52         partition=      Override the PartitionDesc location. (unused)
53         lastblock=      Set the last block of the filesystem/
54
55 The following expect a offset from the partition root.
56
57         fileset=        Override the fileset block location. (unused)
58         rootdir=        Override the root directory location. (unused)
59                         WARNING: overriding the rootdir to a non-directory may
60                                 yield highly unpredictable results.
61 -------------------------------------------------------------------------------
62
63
64 For the latest version and toolset see:
65         http://linux-udf.sourceforge.net/
66
67 Documentation on UDF and ECMA 167 is available FREE from:
68         http://www.osta.org/
69         http://www.ecma-international.org/
70
71 Ben Fennema <bfennema@falcon.csc.calpoly.edu>