home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Chip 2002 February
/
chip_20022115.iso
/
amiga
/
chiputil
/
nulib2.lha
/
nulib2-101
/
nulib2.man
< prev
next >
Wrap
Text File
|
2002-01-03
|
6KB
|
199 lines
NULIB2 (1L) 17 Jan 2000 NULIB2 (1L)
NAME
nulib2 - package and compress (archive) files
SYNOPSIS
¢1mnulib2¢m ¢m-command[modifiers]¢1m¢m¢1m¢m¢1m¢m ¢3marchive¢m
¢3m[¢mfilenames
DESCRIPTION
¢3mnulib2¢m is a disk and file archiver for NuFX (ShrinkIt)
files. It can add files to and extract files from
¢3m.SHK¢m,¢3m¢m¢3m¢m ¢3m.BXY¢m,¢3m¢m¢3m¢m ¢3m.SEA¢m¢3m¢m¢3m¢m
(as created by GS/ShrinkIt), and ¢3m.BSE¢m files.
When extracting, testing, or listing the contents of an archive,
you can specify "-" for the archive name. The archive will be
read from stdin.
Filenames are considered case-sensitive.
This man page contains a summary of available options. For full
documentation and the latest versions, visit
http://www.nulib.com/.
OPTIONS
¢1m-a¢m Add files to an archive. If the archive does not exist,
a new one will be created. The list of files to add must be
given.
¢1m-d¢m Delete files from an archive. The set of files to
delete must be provided.
¢1m-i¢m Integrity test. If no files are listed, all files in
the archive are tested.
¢1m-p¢m Pipe extraction. All extracted files are written to
stdout instead of a file on disk. Normal archive progress
messages are suppressed.
¢1m-t¢m Table of contents. Provides a simple list of files in
the archive, one per line.
¢1m-v¢m Verbose table of contents. Output similar to what
ShrinkIt displays is shown.
¢1m-x¢m Extract files from an archive. If no files are listed,
all files in the archive are extracted.
MODIFIERS
¢1m-0¢m Don't use compression. Files added will be stored
without compression.
Thu Jan 3 15:51:48 2002 Page 1
NULIB2 (1L) 17 Jan 2000 NULIB2 (1L)
¢1m-c¢m Comments. When extracting, comments will be displayed.
When adding, you will be prompted to enter a one-line comment
for every file.
¢1m-e¢m Preserve ProDOS file types. See the ProDOS File Type
Preservation document on http://www.nulib.com/ for details on
how this works.
¢1m-ee¢m Preserve file types, using extended names. A file
extension is appended to extracted files. Useful on operating
systems like Windows, where filename extensions are important.
When adding files, ¢3mnulib2¢m will try to guess at correct file
types by examining the filename extension.
¢1m-f¢m Freshen files. When adding, files in the archive that
are older than files on disk are "freshened", meaning that no
new files are added, and files that are the same age or newer
aren't touched. Works similarly when extracting.
¢1m-j¢m Junk directory names. Only the filename is kept; the
rest of the pathname is thrown away. Empty directories aren't
stored. Works when adding or extracting.
¢1m-k¢m Store files as disk images. Files that are a multiple
of 512 bytes will be added as disk images rather than normal
files. This does not override the "-e" flag.
¢1m-l¢m Auto-convert text files. A reasonably smart algorithm
is used to identify which files are text and which aren't during
extraction. It then converts whatever EOL indicator is being
used by the text file into something appropriate for the current
system.
¢1m-ll¢m Auto-convert all files. All files being extracted are
considered text, and will be converted. Don't use this unless
you're sure you need it.
¢1m-r¢m Recurse into subdirectories. When adding, this causes
¢3mnulib2¢m to descend into subdirectories and store all of the
files found. When extracting, testing, or deleting, this causes
the files listed to match against all records whose prefix
matches, allowing you to extract, test, or delete entire
subdirectories from the archive.
¢1m-u¢m Update files. When adding, files in the archive that
are older than files on disk are updated. Files in the archive
that are the same age or newer aren't touched. New files will
be added. Works similarly when extracting.
EXAMPLES
A simple example:
nulib2 a foo.shk *¢1m
Thu Jan 3 15:51:48 2002 Page 2
NULIB2 (1L) 17 Jan 2000 NULIB2 (1L)
creates the archive ¢3mfoo.shk¢m (assuming it doesn't exist) and
stores all of the files in the current directory in it, in
compressed form.
If you wanted to add all the files in the current directory, as
well as all files in all subdirectories, you could use:
nulib2 ar foo.shk *¢3m
to recursively descend into the directory tree.
Using the command:
nulib2 xe foo.shk¢m
would extract all files from ¢3mfoo.shk,¢m preserving ProDOS
file types. If you then used the command:
nulib2 aer foo.shk *¢3m
you would add the files, preserving the file types of anything
that was extracted with the "-e" flag set.
A handy way to look at text documents is to use:
nulib2 xeel foo.shk¢m
to convert end-of-line terminators (e.g. CRLF to LF) as the
files are being extracted. The "-ee" flag adds ".TXT" to all
files with a ProDOS file type of TXT ($04).
SEE ALSO
compress(1), tar(1), zip(1L), unzip(1L), nulib(1L)
BUGS
Probably.
AUTHOR
Copyright (C) 2000 by Andy McFadden. All Rights Reserved.
Thu Jan 3 15:51:48 2002 Page 3