Config - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Security

  

Config

  

retrieve and update the current security settings

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

Config()

Config( name1 = val1, name2 = val2, ... )

Parameters

name1, name2, ...

-

recognized security setting names

val1, val2, ...

-

boolean names or lists of file specifications, depending on the name; see below

Description

• 

This routine is used to update and retrieve the current security settings. Security settings can only be modified when security is disabled. Changes to security settings are lost on restart.

  

This routine returns the current security settings (prior to the call) as an expression sequence of equations of the form name = val. Here, name is a recognized security setting name and val is, depending on the name, either a boolean or a list of file specifications.

  

If the settings argument is provided, each name = val pair is applied to the current settings, replacing the previous value.

• 

Valid names are:

SECURE_READ_LIST

specification list for permitted read operations

SECURE_NOREAD_LIST

specification list for restricted read operations

SECURE_WRITE_LIST

specification list for permitted write operations

SECURE_NOWRITE_LIST

specification list for restricted write operations

SECURE_EXTCALL_LIST

specification list for permitted external call libraries

SECURE_NOEXTCALL_LIST

specification list for restricted external call libraries

SECURE_SYSCALL_ENABLED

Boolean flag for enabling/disabling calls to system and ssystem

SECURE_MODE

Boolean flag for enabling/disabling security

For any given list of file specifications, if a list item is one of the names SECURE_READ_LIST, SECURE_NOREAD_LIST, SECURE_WRITE_LIST, SECURE_NOWRITE_LIST, SECURE_EXTCALL_LIST, or SECURE_NOEXTCALL_LIST, then the list item is replaced by the current value of that name in the security settings.

• 

For an overview of Maple engine security and an explanation of relevant concepts, see the Maple Engine Security help page.

File Specification

• 

A file specification is a Maple string with the contents as specified in the File Specification for Maple Engine Security help page.

Examples

Security:-Config

SECURE_READ_LIST=,SECURE_NOREAD_LIST=,SECURE_WRITE_LIST=,SECURE_NOWRITE_LIST=,SECURE_EXTCALL_LIST=,SECURE_NOEXTCALL_LIST=,SECURE_SYSCALL_ENABLED=false,SECURE_MODE=false

(1)

Security:-ConfigSECURE_READ_LIST=/tmp/*,SECURE_SYSCALL_ENABLED=true:

NULL

(2)

Security:-ConfigSECURE_READ_LIST=SECURE_READ_LIST,/usr/*:

NULL

(3)

Security:-Config

SECURE_READ_LIST=/tmp/*,/usr/*,SECURE_NOREAD_LIST=,SECURE_WRITE_LIST=,SECURE_NOWRITE_LIST=,SECURE_EXTCALL_LIST=,SECURE_NOEXTCALL_LIST=,SECURE_SYSCALL_ENABLED=true,SECURE_MODE=false

(4)

Security:-ConfigSECURE_READ_LIST=/tmp/*,SECURE_SYSCALL_ENABLED=true:

NULL

(5)

Security:-Config

SECURE_READ_LIST=/tmp/*,SECURE_NOREAD_LIST=,SECURE_WRITE_LIST=,SECURE_NOWRITE_LIST=,SECURE_EXTCALL_LIST=,SECURE_NOEXTCALL_LIST=,SECURE_SYSCALL_ENABLED=true,SECURE_MODE=false

(6)

See Also

EngineSecurity

Security

Security[Test]