NAME

smc_copy - copies content from one Sun MediaCenter server to another

SYNOPSIS

smc_copy [-p] [-s] [-t] source destination

where source and destination each have the form hostname:<filename> or <filename>. Specifying only <filename> implies that a title is stored on or being copied to the machine from which you are invoking smc_copy. Options are described below.

AVAILABILITY

Available with the Sun MediaCenter Server software.

DESCRIPTION

The smc_copy utility copies content, specified by a title name as returned by smc_ls (1), from one Sun MediaCenter server to another.

The syntax for smc_copy is similar to that of rcp (1) , with the following exceptions:

-- You cannot specify a path to a title, in either the source or destination argument. Sun MediaCenter software looks for and stores titles and associated data in hardcoded locations.

--You cannot specify a username in an smc_copy source or destination argument.

As with rcp , you can invoke smc_copy on one machine to copy content from a second machine to a third machine. The machine on which you invoke smc_copy does not have to be a Sun MediaCenter server. To run smc_copy , you must have the smc_copy binary installed on the local machine.

In the course of the copy operation, smc_copy creates a new title on a destination Sun MediaCenter server. You can rename the destination title in an smc_copy command.

When you copy a title to another Sun MediaCenter, you, the copier, own the title access control list for that file. Other users can play the title, but cannot copy it to another server or remove it. To extend access to the newly-copied file, use smc_settacl (1M).

OPTIONS

The smc_copy utility has the following options:

p

Preserve create time in destination file. Otherwise, the create time becomes the current time for the newly copied file.

s

Run in single-threaded mode. By default, the utility runs in multiple threads. This option is used for internal test purposes.

t

Display transfer statistics in shell from which you invoke the utility.

EXAMPLES

The following example copies the title heidi from the Sun MediaCenter server server2 to the local Sun MediaCenter server, server1 .

server1% smc_copy server2:heidi heidi

The following command accomplishes the same function as the preceding:

server1% smc_copy server2:heidi server1:heidi

The following command copies content from a local to a remote Sun MediaCenter server, renaming the title in the process:

server1% smc_copy heidi server2:drama

The following command performs the same function as the preceding, except the title is not renamed:

server1% smc_copy heidi server2:heidi

The following command copies the title heidi from Sun MediaCenter server server1 to the Sun MediaCenter server server2 and renames the title in the process. The command is invoked from a third-party machine, machine_x , which is not an Sun MediaCenter server.

machine_x% smc_copy server1:heidi server2:drama

SEE ALSO

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