1 # Id: README.mkisofs,v 1.1 2000/10/10 20:40:11 beck Exp 2 Note: 3 4 This program requires a lot of virtual memory to run since it 5 builds all of the directories in memory. The exact requirements 6 depend upon a lot of things, but for Rock Ridge discs 12Mb would not 7 be unreasonable. Without RockRidge and without the translation 8 tables, the requirements would be considerably less. 9 10 The cdwrite utility is maintained separately from mkisofs by 11 yggdrasil.com. It is enclosed here as a convenience, since the two programs 12 are often useful together. 13 14 ***************************** 15 Notes for version 1.12 16 17 Joliet support is now complete. See the -J option. 18 19 The file scanning code is much improved - mkisofs can use multiple 20 sources of input files and merge them together to form the output 21 image. In addition, each source can be grafted at any point in the 22 iso9660 image. 23 24 The image writing code has been cleaned up to make it much easier 25 to add custom extensions. 26 27 The ADD_FILES feature has been removed as it didn't work well, 28 and it was hard to figure out. The recent rearrangements in the 29 file scanning code would tend to solve these issues. 30 31 ***************************** 32 Notes for version 1.11 33 34 There is a feature which can be optionally compiled into 35 mkisofs that allows you to merge arbitrary directory trees into the 36 image you are creating. You need to compile with -DADD_FILES for my 37 changes to take effect. Thanks to Ross Biro biro (a] yggdrasil.com. 38 39 ***************************** 40 Notes for version 1.10b1 41 42 Big news is that multi-session capability is very close to being 43 done. There is still a missing interface to cdwrite that is 44 used to determine the next writable address and the sector number 45 of the last existing session. Until we get the interface to cdwrite 46 done, this is a beta version. 47 48 Bug involving DST fixed (dates are always calculated, since some 49 files may be DST and other ones would not be). 50 51 Unfortunately the notes on some of the small patches got lost. 52 53 ***************************** 54 Notes for version 1.06 55 56 Jan-Piet Mens <jpm (a] mens.de> added support for the '-m' switch. This 57 allows exclusion of shell-style globs from the CDROM. 58 See manual mkisofs.8 for more information. 59 60 ***************************** 61 Notes for version 1.05 62 63 Added support for '-r' switch. This is very similar to -R for 64 Rock Ridge, but echos of the development environment are removed 65 (i.e. uid/gid set to 0, and permissions of the files are canonicalized). 66 Useful in applications where a distribution medium is being produced. 67 68 ***************************** 69 Notes for version 1.04 70 71 No notes for 1.04. 72 73 ***************************** 74 Notes for version 1.03 75 76 No notes for 1.03. 77 78 ***************************** 79 Notes for version 1.02. 80 81 Minor bugfixes here and there. Support for compiled in 82 defaults for many of the text fields in the volume header are now 83 present, and there is also support for a file ".mkisofsrc" that can 84 also read settings for these parameters. 85 86 A short script "Configure" was added to allow us to set up special 87 compile options that depend upon the system that we are running on. 88 This should help stamp out the sphaghetti-isms that were starting to grow 89 up in various places in the code. 90 91 You should get more meaningful error messages if you run out of 92 memory. 93 94 ***************************** 95 Notes for version 1.1. 96 97 The big news is that SUSP CE entries are now generated for 98 extremely long filenames and symlink names. This virtually guarantees 99 that there is no limit (OK, well, about 600Mb) for file name lengths. 100 I have tested this as well as I can, and it seems to work with linux. 101 This would only be used very rarely I suspect. 102 103 Also, I believe that support for VMS is done. You must be 104 careful, because only Stream-LF and FIxed length record files can be 105 recorded. The rest are rejected with error messages. Perhaps I am 106 being too severe here. 107 108 There is a bugfix in the sorting of entries on the disc - we 109 need to stop comparing once we reach the ';' character. 110 111 There are four new options -z -d -D -l -V. Some of these tell 112 mkisofs to relax some of the iso9660 restrictions, and many systems 113 apparently do not really seem to mind. Use these with caution. 114 115 Some diagnostic programs to scan disc images are in the diag 116 directory. These are not as portable as mkisofs, and may have some 117 bugs. Still they are useful because they can check for bugs that I might 118 have introduced as I add new features. 119 120 ***************************** 121 Notes for version 1.0. 122 123 In version 1.0, the date fields in the TF fields were fixed - 124 previously I was storing st_ctime as the file creation time instead of 125 the file attribute change time. Thanks to Peter van der Veen for 126 pointing this out. I have one slight concern with this change, 127 however. The Young Minds software is definitely supplying 3 dates 128 (creation, modification and access), and I would strongly suspect that 129 they are incorrectly putting the file attribute change time in the 130 file creation slot. I would be curious to see how the different RRIP 131 filesystems treat this. Anyway, this is something to keep in the back 132 of your mind. 133 134 The symlink handling was not quite correct in 0.99 - this is 135 now fixed. Only some systems seemed to have been affected by this bug. 136 137 A command line option is now present to allow you to 138 specifically exclude certain files from the distribution. 139 140 The case where you do not have permissions to read a directory 141 is now handled better by mkisofs. The directory that cannot be opened 142 is converted into a zero-length file, and processing continues normally. 143 144 A few portability things have been fixed (hopefully). 145 146