1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META http-equiv="Content-Style-Type" content="text/css"> 6<TITLE>darch</TITLE> 7<LINK rel="stylesheet" href="../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>darch</H1> 11 12<H2>Overview</H2> 13<P>This utility archives several files into one file. </P> 14 15<H2>How to Use</H2> 16<P>This tool includes several major modes. Be sure to use all forward slashes when writing path names below. ("\" cannot be used.) </P> 17 18<H3>Create mode</H3> 19<P><CODE>darchD -c file/directory list... arcname</CODE></P> 20<TABLE border="1"> 21 <TBODY> 22 <TR> 23<TD>-c</TD> 24<TD>Specifies the files/directory to be archived.</TD> 25 </TR> 26 <TR> 27<TD>arcname</TD> 28<TD>Archive file name</TD> 29 </TR> 30 </TBODY> 31</TABLE> 32<P>Use this mode when creating an archive. If a directory name is specified, all files within the directory will be placed in the archive. Note: Files and directories are archived in the order specified by this command. </P> 33 34<BLOCKQUOTE><PRE><CODE> 35Example: 36$ pwd 37/RVL_SDK/dvddata 38$ darchD -c constitu constitu.arc 39$ darchD -l constitu.arc 40constitu/article1/section1 41constitu/article1/section2 42constitu/article1/section3 43...... 44$ 45</CODE></PRE></BLOCKQUOTE> 46 47<H3>Extract mode</H3> 48<P><CODE>darchD -x directory arcname</CODE></P> 49<TABLE border="1"> 50 <TBODY> 51 <TR> 52<TD>-x</TD> 53<TD>Specifies the directory in which to place extracted files.</TD> 54 </TR> 55 <TR> 56<TD>arcname</TD> 57<TD>Archive file name</TD> 58 </TR> 59 </TBODY> 60</TABLE> 61 62<P>Use this mode when extracting from an archive. A directory that does not exist must be specified as the directory to use for extraction. </P> 63<BLOCKQUOTE><PRE><CODE> 64Example: 65$ ls tmp 66ls: tmp: No such file or directory 67$ darchD -x tmp constitu.arc 68Position Length name 69----------------------- 70d 0 0 constitu/ 71d 0 0 constitu/article1/ 72- 512 209 constitu/article1/section1 73...... 74$ ls tmp 75constitu/ 76$ 77</CODE></PRE></BLOCKQUOTE> 78 79<H3>Diff mode</H3> 80<P><CODE>darchD -d directory arcname</CODE></P> 81<TABLE border="1"> 82 <TBODY> 83 <TR> 84<TD><code>-d</code></TD> 85<TD>Specifies a work directory. </TD> 86 </TR> 87 <TR> 88<TD>arcname</TD> 89<TD>Archive file name</TD> 90 </TR> 91 </TBODY> 92</TABLE> 93 94<P>Be sure to use this mode when comparing the contents of an archive with actual files. Move to the specified work directory and compare whether each file in the archive matches files located in the work directory. </P> 95<BLOCKQUOTE><PRE><CODE> 96Example: 97$ pwd 98/RVL_SDK/dvddata 99$ darchD -d . constitu.arc 100constitu/ 101constitu/article1/ 102constitu/article1/section1 103...... 104$ 105</CODE></PRE></BLOCKQUOTE> 106 107<H3>List mode</H3> 108<P><CODE>darchD -l arcname</CODE></P> 109<TABLE border="1"> 110 <TBODY> 111 <TR> 112<TD><code>-l</code></TD> 113<TD>Lists the files included in the archive in the order they appear in the file.</TD> 114 </TR> 115 <TR> 116<TD>arcname</TD> 117<TD>Archive file name</TD> 118 </TR> 119 </TBODY> 120</TABLE> 121 122<P>Use this mode to view the contents of an archive. When used with the -v option, you can view offset and length for each file.</P> 123<BLOCKQUOTE><PRE><CODE> 124Example: 125$ darchD -l constitu.arc 126constitu/article1/section1 127constitu/article1/section2 128constitu/article1/section3 129...... 130$ darchD -lv constitu.arc 131File start offset: 0x00000200 132 133Position Length name 134-------------------------------------- 1350x00000200 0x000000d1 constitu/article1/section1 1360x000002e0 0x0000075b constitu/article1/section2 1370x00000a40 0x00000826 constitu/article1/section3 138...... 139$ 140</CODE></PRE></BLOCKQUOTE> 141 142<H3>List mode 2</H3> 143<P><CODE>darchD -t arcname</CODE></P> 144<TABLE border="1"> 145 <TBODY> 146 <TR> 147<TD>-t</TD> 148<TD>Lists files included in the archive in a format similar to tar. </TD> 149 </TR> 150 <TR> 151<TD>arcname</TD> 152<TD>Archive file name</TD> 153 </TR> 154 </TBODY> 155</TABLE> 156 157<P>Use this mode to list the contents of the archive in a format similar to tar (i.e., the full path of each file name is displayed). Note: The order in which files are displayed does not necessarily match the order of files in the archive.</P> 158<BLOCKQUOTE><PRE><CODE> 159Example: 160$ darchD -t constitu.arc 161constitu/ 162constitu/article1/ 163constitu/article1/section1 164...... 165$ darchD -tv constitu.arc 166Position Length name 167----------------------- 168d 0 0 constitu/ 169d 0 0 constitu/article1/ 170- 512 209 constitu/article1/section1 171...... 172</CODE></PRE></BLOCKQUOTE> 173 174<H3>Delete mode</H3> 175<P><CODE>darchD -e file/directory list arcname</CODE></P> 176<TABLE border="1"> 177 <TBODY> 178 <TR> 179<TD>-e</TD> 180<TD>Specifies the files/directories to be deleted from the archive.</TD> 181 </TR> 182 <TR> 183<TD>arcname</TD> 184<TD>Archive file name</TD> 185 </TR> 186 </TBODY> 187</TABLE> 188 189<P>Use this mode to delete specified files/directories from the archive. </P> 190<BLOCKQUOTE><PRE><CODE> 191Example: 192$ darchD -l constitu.arc 193constitu/article1/section1 194constitu/article1/section2 195constitu/article1/section3 196...... 197$ darchD -e constitu/article1/section1 constitu.arc 198$ darchD -l constitu.arc 199constitu/article1/section2 200constitu/article1/section3 201...... 202$ 203</CODE></PRE></BLOCKQUOTE> 204 205<H3>Other Options</H3> 206<TABLE border="1"> 207 <TBODY> 208 <TR> 209<TD>-v</TD> 210<TD>Turns verbose mode ON.</TD> 211 </TR> 212 <TR> 213<TD><code>-h</code></TD> 214<TD>Displays a help message.</TD> 215 </TR> 216 </TBODY> 217</TABLE> 218 219<H2>Tips</H2> 220<P>The order of files/directories can be specified as shown below. </P> 221<BLOCKQUOTE><PRE><CODE> 222$ less filelist 223constitu/article3/section3 224constitu/article2/section2 225constitu/article2/section4 226constitu/article1/section1 227constitu/article2/section1 228constitu/article1/section2 229constitu/article1/section3 230constitu/article1/section4 231constitu/article3/section2 232constitu/article2/section3 233constitu/article1/section5 234constitu/article1/section7 235constitu/article1/section8 236constitu/article3/section1 237constitu/article1/section9 238constitu/article1/section6 239constitu/article1/sectionA 240$ darchD -c `less filelist` constitu.arc 241$ 242</CODE></PRE></BLOCKQUOTE> 243 244<P>The order of files can be easily changed by editing this file. Use the following command to list all files within a directory in the format described above. </P> 245<BLOCKQUOTE><PRE><CODE> 246$ find directory -type f -name "*" 247</CODE></PRE></BLOCKQUOTE> 248 249<P>Use the -l option to list files already in the archive in the format described above. </P> 250<BLOCKQUOTE><PRE><CODE> 251$ darchD -l arcname 252</CODE></PRE></BLOCKQUOTE> 253 254<H2>Revision History</H2> 255<P>05/15/2006 Initial version.</P> 256 257</BODY> 258</HTML> 259