create_rs_command

Use the create_rs_command command to create a new restricted shell command for the currently selected restricted shell environment.

Syntax

create_rs_command rsc_name cmd description form dzsh_runas flags pri umask path

Options

This command takes no options.

Arguments

This command takes the following arguments:

Argument Type Description

rsc_name

string

Required. Specifies the name of the restricted shell command.

cmd

string

Required. Specifies the restricted shell command string or strings. You can use wild cards or a regular expression.

description

string

Optional. Specifies the text describing the restricted shell command.

form

integer

Optional. Indicates whether the cmd and path strings use wild cards (0) or a regular expression (1).

dzsh_runas

string

Optional. Specifies the list of users and groups that can run this command in a restricted shell environment (dzsh). Users can be listed by user name or UID.

flags

string

Optional. Specifies an integer that specifies a combination of different properties for the command.

For more information about setting this field, see set_rsc_field.

pri

integer

Optional. Specifies the command priority for the restricted shell command object.

For more information about setting this field, see set_rsc_field.

umask

integer

Optional. Specifies an integer that defines who can execute the command.

For more information about setting this field, see set_rsc_field.

path

string

Optional. Specifies the path to the restricted command. You can use wild cards, a regular expression, or one of the following keywords:

  • USERPATH to set to the command path to the equivalent of the Standard user path option.
  • SYSTEMPATH to set to the path to the equivalent of the Standard system path option.
  • SYSTEMSEARCHPATH to set to the path to the equivalent of the System search path option.

If you don’t specify this argument, the default is USERPATH.

Return value

This command returns nothing if it runs successfully.

Examples

create_rs_command test_id id {Sample restricted command description}

Related Tcl library commands

The following commands perform actions related to this command: