📄 tarlib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/tarLib.html - generated by refgen from tarLib.c --> <title> tarLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.htm"><i>VxWorks API Reference : OS Libraries</i></a></p></blockquote><h1>tarLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>tarLib</strong> - UNIX tar compatible library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><a href="./tarLib.html#tarExtract">tarExtract</a>( )</b> - extract all files from a tar formatted tape<br><b><a href="./tarLib.html#tarArchive">tarArchive</a>( )</b> - archive named file/dir onto tape in tar format<br><b><a href="./tarLib.html#tarToc">tarToc</a>( )</b> - display all contents of a tar formatted tape<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p><p>This library implements functions for archiving, extracting and listingof UNIX-compatible "tar" file archives.It can be used to archive and extract entire file hierarchiesto/from archive files on local or remote disks, or directly to/frommagnetic tapes.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./dosFsLib.html#top">dosFsLib</a></b><p></blockquote><h4>CURRENT LIMITATIONS</h4><blockquote><p>This Tar utility does not handle MS-DOS file attributes,when used in conjunction with the MS-DOS file system.The maximum subdirectory depth supported by this library is 16,while the total maximum path name that can be handled by tar is limited at 100 characters.<hr><a name="tarExtract"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>tarExtract( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>tarExtract( )</strong> - extract all files from a tar formatted tape</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS tarExtract ( char * pTape, /* tape device name */ int bfactor, /* requested blocking factor */ BOOL verbose /* if TRUE print progress info */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This is a UNIX-tar compatible utility that extracts entirefile hierarchies from tar-formatted archive.The files are extracted with their original names and modes.In some cases a file cannot be created on disk, for example ifthe name is too long for regular DOS file name conventions,in such cases entire files are skipped, and this program willcontinue with the next file. Directories are created in orderto be able to create all files on tape.<p>The <i>tape</i> argument may be any tape device name or file namethat contains a tar formatted archive. If <i>tape</i> is equal "-",standard input is used. If <i>tape</i> is NULL (or unspecified from Shell)the default archive file name stored in global variable <i>TAPE</i> is used.<p>The <i>bfactor</i> dictates the blocking factor the tape was written with.If 0, or unspecified from the shell, a default of 20 is used.<p>The <i>verbose</i> argument is a boolean, if set to 1, will cause informativemessages to be printed to standard error whenever an action is taken,otherwise, only errors are reported.<p>All informative and error message are printed to standard error.<p>There is no way to selectively extract tar archives with thisutility. It extracts entire archives.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tarLib.html#top">tarLib</a></b><hr><a name="tarArchive"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>tarArchive( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>tarArchive( )</strong> - archive named file/dir onto tape in tar format</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS tarArchive ( char * pTape, /* tape device name */ int bfactor, /* requested blocking factor */ BOOL verbose, /* if TRUE print progress info */ char * pName /* file/dir name to archive */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This function creates a UNIX compatible tar formatted archiveswhich contain entire file hierarchies from disk file systems.Files and directories are archived with mode and time informationas returned by <b><a href="./dirLib.html#stat">stat</a>( )</b>.<p>The <i>tape</i> argument can be any tape drive device name or a name of anyfile that will be created if necessary, and will contain the archive.If <i>tape</i> is set to "-", standard output will be used.If <i>tape</i> is NULL (unspecified from Shell), the default archive filename stored in global variable <i>TAPE</i> will be used.<p>Each <b><a href="./ioLib.html#write">write</a>( )</b> of the archive file will be exactly <i>bfactor</i>*512 byteslong, hence on tapes in variable mode, this will be the physicalblock size on the tape. With Fixed Mode tapes this is only a performancematter. If <i>bfactor</i> is 0, or unspecified from Shell, it will be setto the default value of 20.<p>The <i>verbose</i> argument is a boolean, if set to 1, will cause informativemessages to be printed to standard error whenever an action is taken,otherwise, only errors are reported.<p>The <i>name</i> argument is the path of the hierarchy to be archived.if NULL (or unspecified from the Shell), the current directory path "."will be used. This is the path as seen from the target, not from the Tornado host.<p>All informative and error message are printed to standard error.<p></blockquote><h4>NOTE</h4><blockquote><p>Refrain from specifying absolute path names in <i>path</i>, such archivestend to be either difficult to extract or can cause unexpecteddamage to existing files if such exist under the same absolute name.<p>There is no way of specifying a number of hierarchies to dump.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tarLib.html#top">tarLib</a></b><hr><a name="tarToc"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>tarToc( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>tarToc( )</strong> - display all contents of a tar formatted tape</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS tarToc ( char * tape, /* tape device name */ int bfactor /* requested blocking factor */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This is a UNIX-tar compatible utility that displays entirefile hierarchies from tar-formatted media, e.g. tape.<p>The <i>tape</i> argument may be any tape device name or file namethat contains a tar formatted archive. If <i>tape</i> is equal "-",standard input is used. If <i>tape</i> is NULL (or unspecified from Shell)the default archive file name stored in global variable <i>TAPE</i> is used.<p>The <i>bfactor</i> dictates the blocking factor the tape was written with.If 0, or unspecified from Shell, default of 20 is used.<p>Archive contents are displayed on standard output, whileall informative and eror message are printed to standard error.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tarLib.html#top">tarLib</a></b></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -