ns_perm

Overview

Add, delete, update, or get information on permissions records

Syntax

ns_perm add ?-server servername? method URL owner allowusers users allowgroups groups hoststoallow hoststodeny inherit

ns_perm adminhoststoallow ?-server servername? ?hoststoallow?

ns_perm adminhoststodeny ?-server servername? ?hoststodeny?

ns_perm allowgroups ?-server servername? method URL inherit

ns_perm allowusers ?-server servername? method URL inherit

ns_perm delete ?-server servername? method URL inherit

ns_perm exists ?-server servername? method URL inherit

ns_perm groups ?-server servername? method URL inherit

ns_perm hoststoallow ?-server servername? method URL inherit

ns_perm hoststodeny ?-server servername? method URL inherit

ns_perm inherit ?-server servername? method URL

ns_perm list ?-server servername?

ns_perm method ?-server servername? method URL

ns_perm owner ?-server servername? method URL inherit

ns_perm syncoff ?-server servername?

ns_perm syncon ?-server servername?

ns_perm url ?-server servername? method URL

ns_perm users ?-server servername? method URL inherit

Description

ns_perm add adds a permission record for the specified method and URL. Specify the owner of the permission record in owner. If no servername is specified, the current virtual server is used.

Specify 0 in the allowusers argument and an empty list in the users argument if there are no restrictions on users. Specify 1 in the allowusers argument and a list of users to allow in the users argument if you want to specify users to allow. Specify 0 in the allowusers argument and a list of users to deny in the users argument if you want to specify users to deny.

Specify 0 in the allowgroups argument and an empty list in the groups argument if there are no restrictions on groups. Specify 1 in the allowgroups argument and a list of groups to allow in the groups argument if you want to specify groups to allow. Specify 0 in the allowgroups argument and a list of groups to deny in the groups argument if you want to specify groups to deny.

Specify a list of hosts to allow and a list of hosts to deny in the hoststoallow and hoststodeny arguments, respectively. Specify 1 (one) in the inherit argument if the permission record on the specified URL is to be inherited to lower URLs and 0 (zero) if it is not.

ns_perm adminhoststoallow either sets or returns the list of hosts to allow for the nsadmin user. If hoststoallow is specified, the specified list of hosts will be allowed for the nsadmin user. If hoststoallow is not specified, the list of hosts allowed for nsadmin is returned. If no servername is specified, the current virtual server is used.

ns_perm adminhoststodeny either sets or returns the list of hosts to deny for the nsadmin user. If hoststodeny is specified, the specified list of hosts will be denied for the nsadmin user. If hoststodeny is not specified, the list of hosts denied for nsadmin is returned. If no servername is specified, the current virtual server is used.

ns_perm allowgroups returns the allowgroups setting for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm allowusers returns the allowusers setting for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm delete deletes the permission record for the specifed method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm exists returns 1 (one) if a permission record for the specified method, URL, and inherit combination exists and 0 (zero) if it does not. If no servername is specified, the current virtual server is used.

ns_perm groups returns a list of allowed groups for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm hoststoallow returns the list of hosts to allow for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm hoststodeny returns the list of hosts to deny for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm inherit returns the inheritance setting of the permission record matching the specified method/URL combination. If no servername is specified, the current virtual server is used.

ns_perm list returns a list of method/URL/inherit combinations. If no servername is specified, the current virtual server is used.

ns_perm method returns the method of the permission record matching the specified method/URL combination. If no servername is specified, the current virtual server is used.

ns_perm owner returns the owner of the permission record for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.

ns_perm syncoff disables file synchronization to allow for large-scale loading of permissions, users, groups, or methods. Normally, calls to ns_perm, ns_user, ns_group, and ns_method functions update the corresponding disk files each time they are called, making large-scale loading extremely inefficient. If you want to perform large-scale loading, first call ns_perm syncoff to disable the file synchronization mechanism, then make multiple calls to ns_perm, ns_user, ns_group or ns_method, and finally call ns_perm syncon to re-enable the file synchronization. If no servername is specified, the current virtual server is used.

ns_perm syncon synchronizes files and enables file synchronization after large-scale loading of permissions, users, groups, or methods. If no servername is specified, the current virtual server is used.

ns_perm url returns the inherited URL, or the actual URL if it is not inherited.

ns_perm users returns a list of allowed users for the specified method, URL, and inherit combination. If no servername is specified, the current virtual server is used.