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 only 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.</P> 33<P><strong>Note:</strong> Files and directories are archived in the order specified by this command.</P> 34 35<BLOCKQUOTE><PRE><CODE>Example: 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>Example: 64$ ls tmp 65ls: tmp: No such file or directory 66$ darchD -x tmp constitu.arc 67 Position Length name 68----------------------- 69d 0 0 constitu/ 70d 0 0 constitu/article1/ 71- 512 209 constitu/article1/section1 72...... 73$ ls tmp 74constitu/ 75$ 76</CODE></PRE></BLOCKQUOTE> 77 78<H3>Diff Mode</H3> 79<P><CODE>darchD -d directory arcname</CODE></P> 80<TABLE border="1"> 81 <TBODY> 82 <TR> 83<TD><code>-d</code></TD> 84<TD>Specifies a work directory. </TD> 85 </TR> 86 <TR> 87<TD>arcname</TD> 88<TD>Archive file name</TD> 89 </TR> 90 </TBODY> 91</TABLE> 92 93<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> 94<BLOCKQUOTE><PRE><CODE>Example: 95$ pwd 96/RVL_SDK/dvddata 97$ darchD -d . constitu.arc 98constitu/ 99constitu/article1/ 100constitu/article1/section1 101...... 102$ 103</CODE></PRE></BLOCKQUOTE> 104 105<H3>List Mode</H3> 106<P><CODE>darchD -l arcname</CODE></P> 107<TABLE border="1"> 108 <TBODY> 109 <TR> 110<TD><code>-l</code></TD> 111<TD>Lists the files included in the archive in the order they appear in the file.</TD> 112 </TR> 113 <TR> 114<TD>arcname</TD> 115<TD>Archive file name</TD> 116 </TR> 117 </TBODY> 118</TABLE> 119 120<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> 121<BLOCKQUOTE><PRE><CODE>Example: 122$ darchD -l constitu.arc 123constitu/article1/section1 124constitu/article1/section2 125constitu/article1/section3 126...... 127$ darchD -lv constitu.arc 128File start offset: 0x00000200 129 130 Position Length name 131-------------------------------------- 132 0x00000200 0x000000d1 constitu/article1/section1 133 0x000002e0 0x0000075b constitu/article1/section2 134 0x00000a40 0x00000826 constitu/article1/section3 135...... 136$ 137</CODE></PRE></BLOCKQUOTE> 138 139<H3>List Mode 2</H3> 140<P><CODE>darchD -t arcname</CODE></P> 141<TABLE border="1"> 142 <TBODY> 143 <TR> 144<TD>-t</TD> 145<TD>Lists files included in the archive in a format similar to tar. </TD> 146 </TR> 147 <TR> 148<TD>arcname</TD> 149<TD>Archive file name</TD> 150 </TR> 151 </TBODY> 152</TABLE> 153 154<P>Use this mode to list the contents of the archive in a format similar to tar (that is, the full path of each file name is displayed).</P> 155<P><strong>Note:</strong> The order in which files are displayed does not necessarily match the order of files in the archive.</P> 156<BLOCKQUOTE><PRE><CODE>Example: 157$ darchD -t constitu.arc 158constitu/ 159constitu/article1/ 160constitu/article1/section1 161...... 162$ darchD -tv constitu.arc 163 Position Length name 164----------------------- 165d 0 0 constitu/ 166d 0 0 constitu/article1/ 167- 512 209 constitu/article1/section1 168...... 169</CODE></PRE></BLOCKQUOTE> 170 171<H3>Delete Mode</H3> 172<P><CODE>darchD -e file/directory list arcname</CODE></P> 173<TABLE border="1"> 174 <TBODY> 175 <TR> 176<TD>-e</TD> 177<TD>Specifies the files/directories to be deleted from the archive.</TD> 178 </TR> 179 <TR> 180<TD>arcname</TD> 181<TD>Archive file name</TD> 182 </TR> 183 </TBODY> 184</TABLE> 185 186<P>Use this mode to delete specified files/directories from the archive. </P> 187<BLOCKQUOTE><PRE><CODE>Example: 188$ darchD -l constitu.arc 189constitu/article1/section1 190constitu/article1/section2 191constitu/article1/section3 192...... 193$ darchD -e constitu/article1/section1 constitu.arc 194$ darchD -l constitu.arc 195constitu/article1/section2 196constitu/article1/section3 197...... 198$ 199</CODE></PRE></BLOCKQUOTE> 200 201<H3>Other Options</H3> 202<TABLE border="1"> 203 <TBODY> 204 <TR> 205<TD>-v</TD> 206<TD>Turns verbose mode ON.</TD> 207 </TR> 208 <TR> 209<TD><code>-h</code></TD> 210<TD>Displays a help message.</TD> 211 </TR> 212 </TBODY> 213</TABLE> 214 215<H2>Tips</H2> 216<P>The order of files/directories can be specified as shown below. </P> 217<BLOCKQUOTE><PRE><CODE>$ less filelist 218constitu/article3/section3 219constitu/article2/section2 220constitu/article2/section4 221constitu/article1/section1 222constitu/article2/section1 223constitu/article1/section2 224constitu/article1/section3 225constitu/article1/section4 226constitu/article3/section2 227constitu/article2/section3 228constitu/article1/section5 229constitu/article1/section7 230constitu/article1/section8 231constitu/article3/section1 232constitu/article1/section9 233constitu/article1/section6 234constitu/article1/sectionA 235$ darchD -c `less filelist` constitu.arc 236$ 237</CODE></PRE></BLOCKQUOTE> 238 239<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> 240<BLOCKQUOTE><PRE><CODE> 241$ find directory -type f -name "*" 242</CODE></PRE></BLOCKQUOTE> 243 244<P>Use the -l option to list files already in the archive in the format described above. </P> 245<BLOCKQUOTE><PRE><CODE> 246$ darchD -l arcname 247</CODE></PRE></BLOCKQUOTE> 248 249<H2>Revision History</H2> 250<P>2006/05/15 Initial version.</P> 251 252<hr> 253<P>CONFIDENTIAL</p> 254</BODY> 255</HTML> 256