NAME

smc_settacl - set title access control list for Sun MediaCenter server

SYNOPSIS

smc_settacl -s|m <acl_entries> [ server: ] <titlename>...

smc_settacl -d <title_users> [ server: ] <titlename>...
smc_settacl -f <filename> [ server: ] <titlename>...

AVAILABILITY

Available with the Sun MediaCenter Server software.

DESCRIPTION

smc_settacl allows you to set, modify, or delete the access control list (ACL) associated with a title on a Sun MediaCenter server. After copying a video file (title) to a server, you must use smc_settacl if you want other users to be able copy, append to, or delete that title.

OPTIONS

-s <acl_entries>

[ server: ] <titlename>...

Replace the current title ACL with an ACL containing the information specified in <acl_entries>. <acl_entries> stands for a comma-separated list of items of the form:

u[ser]:<username>:<permissions>

<username> is a Solaris login name; <permissions> is one or more of r, w, and a (read, write, and admin, respectively). You specify permissions in the order rwa. Replace any permission you are not setting with a hyphen. So, for example, if you are setting only admin permission, you specify --a; if you are setting only read and admin, specify r-a. Permissions are defined in the Sun MediaCenter Server Programmer's Guide .

-m <acl_entries>

[ server: ] <titlename>...

Modify the current title ACL according to <acl_entries>. If you specify a user who is not in the title ACL, that user is appended to the ACL. If you specify a user who is in the ACL, the permissions for that user are changed to what you specify.

-d <title_users>

[ server: ] <titlename>...

From the ACL for a specified title, deletes users specified in <title_users>, which is a comma-separated list of items of the form:

u[ser]: <username>

where <username> is a Solaris login name.

-f <filename>

[ server: ] <titlename>...

Set the ACL(s) for the specified title(s) according to the contents of <filename>, a text file containing a list of entries of the form of <acl_entries>, above, with one entry per line. You can have comments in the file; comments are indicated by a hash mark in column 1.

You cannot use the -s and -f options with any other option. You can combine -m and -d.

For the -s, -m, and -d options and in an entry in a file introduced by -f, you can use an asterisk in the user field, which means "any user".

For all options, you can specify one or more titles, any of which can be local or remote. Specify multiple title names with a space between each pair. For a remote title, you prepend the name of the Sun MediaCenter server and a colon to the title name. You can use an asterisk in the title name field to stand for all titles on a server. You must use a backslash (\) to escape the asterisk.

EXAMPLES

The following command replaces an ACL associated with the title "bambi" with an ACL that allows the user "srinivasan" read and admin access.

% smc_settacl -s u:srinivasan:r-a bambi

The following command modifies the ACL associated with the title "bambi", adding the user "srinivasan", with read and admin access.

% smc_settacl -m u:srinivasan:r-a bambi

The following command deletes the user "srinivasan" from the ACL for the title "bambi" on the remote server "nicene".

% smc_settacl -d u:srinivasan nicene:bambi

The following command sets the ACLs for all titles on the remote server "nicene" according to the contents of the file "acl_list".

% smc_settacl -f /home/admin/acl_list nicene:\*

SEE ALSO

smc_tar (1), smc_copy (1), smc_gettacl (1M)