NAME

smc_tar - move content between tar device or file and the Media File System on Sun MediaCenter server

SYNOPSIS

smc_tar t|c|x[v][b][w] f device [blksize]

AVAILABILITY

Available with the Sun MediaCenter Server software.

DESCRIPTION

The smc_tar command loads properly prepared multimedia content from a tar device, such as an 8mm tape, or a file onto the Media Filesystem (MFS). Content must prepared according to the rules specified in the Sun MediaCenter software documentation. These rules include the following:

a single title per tar device;

a Table of Contents (TOC) file for each title;

an index file for each title;

a separate MPEG stream for each playback speed and direction different from normal

speed, forward direction.

In the course of loading content, smc_tar parses the TOC file, does error-checking with respect to the index file, and converts the MPEG bit streams to MFS files.

Note that ftp, in conjunction with the Sun MediaCenter ftp daemon, is the preferred method of loading content onto a Sun MediaCenter server.

With the c option, you can use smc_tar to back up content from a Sun MediaCenter server to tar device or file.

You can use smc_tar from a machine that is not a Sun MediaCenter server and from a remote Sun MediaCenter server, to move content between a server and a local or remote tar device or file. You need only the smc_tar binary, available on a Sun MediaCenter server, to run the utility.

The smc_tar command is analogous to the Unix filesystem tar (1) utility.

smc_tar has a single mandatory argument, f, which precedes the name of the tar device.

OPTIONS

b blksize

Where blksize is the block size that was used to create the tar contents. blksize must be a multiple of 20 and, if present, is the last argument in the smc_tar command line. One block equals 512 bytes. The recommended block size is 500, which is 256000 bytes. Most operating systems, including Solaris, have a default block size of 20.

c

Specifies creation of a tar file or copying a title from the Sun MediaCenter server to a tar device. Requires a source file argument, one or more of <server>:<title>, where <title> can be the wildcard asterisk, meaning all titles on a server. Used primarily for backup.

t

Display a table of contents of the specified tar device or file.

v

Verbose. Display progress of command.

w

Prompt user before overwriting already-existing content.

x

Specifies extraction from the named tar device or file.

<device>

The tar device from which you are extracting content.

EXAMPLES

The following example loads content from the tar device /dev/rmt/0 , specifying a block size of 40 and prompting you before overwriting existing files:

server% smc_tar xwbf 40 /dev/rmt/0

The following command copies all of the files on a remote server to a local tape device:

remote_host% smc_tar cf /dev/rmt/0 smc_server:

Note that you must use a backslash (\) to escape the asterisk.

The following command gives you a table of contents for the titles stored in a tape device on a remote Sun MediaCenter server:

host% smc_tar tvf remote_server:/dev/rmt/0

SEE ALSO

tar (1), smc_ls (1), smc_rm (1), smc_settacl (1M), smc_gettacl (1M), smc_ftpd (1M)