Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME star - Creates tape archives and adds or extract files SYNOPSIS star [options] ... [file] ... AVAILABILITY SUNWsamfs DESCRIPTION This man(1) page describes the GNU version of the tar(1) command as extended by Oracle Corporation. Oracle Corporation has enhanced the tar(1) command to support the Sun QFS and SAM-QFS file systems. The star command saves many files together into a single tape or disk archive, and it can be used to restore individual files from the archive. OPTIONS This command accepts options in both single-character and multicharacter equivalent option formats. Main Operation Mode Options -t, --list Lists the content of an archive. -x, -extract, -get Extracts files from an archive. -c, --create Creates a new archive. -d, --diff, --compare Finds differences between archive and file system. -r, --append Appends files to the end of an archive. -u, --update Only appends files newer than the copy in archive. -A, --catenate, --concatenate Appends tar(1) files to an archive. --delete Deletes from the archive (not on mag tapes!). Operation Modifier Options -W, --verify Attempts to verify the archive after writing it. --remove-files Removes files after adding them to the archive. -k, --keep-old-files Does not overwrite existing files when extracting. -U, --unlink-first Removes each file prior to extracting over it. --recursive-unlink Empties hierarchies prior to extracting directory. -S, --sparse Handles sparse files efficiently. -O, --to-stdout Extracts files to standard output. -G, --incremental Handles old GNU-format incremental backup. -g, --listed-incremental Handles new GNU-format incremental backup. --ignore-failed-read Does not exit with nonzero on unreadable files. File Attribute Handling Options --owner=name Forces name as the owner for added files. --group=name Forces name as the group for added files. --mode=changes Forces (symbolic) mode changes for added files. --atime-preserve Does not change access times on dumped files. -m, --modification-time Does not extract file modified time. --same-owner Tries extracting files with the same ownership. --numeric-owner Specifies to always use numbers for user/group names. -p, --same-permissions, --preserve-permissions Extracts all protection information. -s, --same-order, --preserve-order Sorts names to extract to match archive. --preserve Same as specifying both -p and -s. Device Selection and Switching Options -f=archive, --file=archive Uses archive file or device archive. The archive can be file, host:file or user@host:file. --force-local Specifies that archive file is local even if has a colon. --rsh-command=command Specifies to use remote command instead of rsh. -[0-7][lmh] Specifies drive and density. -M, --multi-volume Creates/lists/extracts multivolume archive. -L=num, --tape-length=num Changes tape after writing num x 1024 bytes. -F=file, --info-script=file, --new-volume-script=file Runs script in file at the end of each tape (implies -M). --volno-file=file Uses/updates the volume number in file. Device Blocking Options -b=blocks, --blocking-factor=blocks Specifies blocks x 512 bytes per record. --record-size=size Specifies size bytes per record, multiple of 512. -i, --ignore-zeros Ignores zeroed blocks in archive (means EOF). -B, --read-full-records Specifies to reblock as the file is being read (for 4.2BSD pipes). Archive Format Selection Options -V=name_or_pattern, --label=name_or_pattern Creates archive with volume name name or globbing pattern pattern at list/extract time. -o, --old-archive, --portability Writes a V7 format archive. --posix Writes a POSIX-conformant archive (GNU). Support for POSIX is only partially implemented. The star command cannot read, nor can it produce, --posix archives. If the POSIXLY_CORRECT environment variable is set, GNU extensions are disallowed with --posix. -z, --gzip, --ungzip Filters the archive through gzip(1). -Z, --compress, --uncompress Filters the archive through compress(1). --use-compress-program=prog Filters through prog (must accept -d). Local File Selection Options -C=dir, --directory=dir Changes to directory dir. -T=name, --files-from=name Gets names to extract or create from file name. --null Instructs star to expect file names terminated with NUL characters so star can work correctly with file names that contain newline characters. Must be specified in conjunction with the -t or the -files-from=name option. Disables the -C option. --exclude=pattern Excludes files, given as a globbing pattern. -X=file, --exclude-from=file Excludes globbing patterns listed in file. -P, --absolute-names Does not strip leading slash characters (/) from file names. -h, --dereference Dumps instead the files to which symlinks point. --no-recursion Avoids descending automatically in directories. -l, --one-file-system Stays in local file system when creating archive. -K=name, --starting-file=name Begins at file name in the archive. -n, --newer_than_existing Only restores files newer than the existing copy. -N=date, --newer=date, --after-date=date Only restores files newer than date. --newer-mtime Compares date and time when data changed only. --backup[=control] Backs up before removal, chooses version control. You can use the VERSION_CONTROL environment variable or the control argument to specify version control. The possible values for control are as follows: control Values Version t, numbered Makes numbered backups. nil, existing Makes numbered if numbered backups exist, simple otherwise. never, simple Specifies to always make simple backups. --suffix=suffix Backs up before removal. Overrides usual suffix. By default, the backup suffix is a tilde character (~). You can use this option or the SIMPLE_BACKUP_SUFFIX environment variable to specify an alternative suffix. Informative Output Message Options --help Writes help text (which is this man(1) page), then exits. --version Writes the tar(1) program version number, then exits. -v, --verbose Lists files processed verbosely. --checkpoint Writes directory names while reading the archive. --totals Writes total bytes written while creating archive. -R, --block-number Shows block number within archive with each message. -w, --interactive, --confirmation Prompts for confirmation for every action. Input File Option file The file can be a file or a device. NOTES The star(1) command defaults to -f- and -b20. Be careful when combining options. The star(1) command supports old-style tar combined options without the leading "-", e.g. /opt/SUNWsamfs/sbin/star tvbf 128 file sets the blocksize to 64K and uses "file" as the archive. However, /opt/SUNWsamfs/sbin/star -tvbf 128 file sets the blocksize to "f" and uses "128" as the archive. If you want to use the leading "-" you should separate the options as follows: /opt/SUNWsamfs/sbin/star -tv -b 128 -f file SEE ALSO For more information about the star(1) command, enter the following command: /opt/SUNWsamfs/sbin/star --help tar(1)