techGetPermissions

techGetPermissions(
d_techFileID
) 
=> l_permissions / nil

Description

Returns the permissions explicitly applied to the specified technology database.

Arguments

d_techFileId

The database identifier of the technology file.

Value Returned

l_permissions

A list of the permissions set on the technology file.

The software returns the permissions for any section with read-only or read/write permissions explicitly set. The following defines the format in which the software returns the information:

((sectionName1
     (list_of_read-only_names) | nil
     (list_of_read/write_names) | nil
    )
    (sectionName2
     (list_of_read-only_names) | nil
     (list_of_read/write_names) | nil
    )
    )

The software may return the names of both users with read-only permissions and users with read/write permissions on the same line, particularly if one of them is nil, but it always returns the names of users with read-only permissions first, followed by the names of users with read/write permissions.

nil

The technology file does not exist, or no permissions are explicitly set on it.

Example

techGetPermissions( tfID )
=> (
    ("layerDefinitions"
           ("joe") 
              nil
     )
    ("devices" 
           ("joe")
           ("mary")
     )
    ("constraintGroups"
           ("fred" "jim")
           ("mary" "bob")
     )
  )

Displays the permissions assigned to the technology file with the database identifier stored in tfID.Three sections in this technology file have permissions explicitly assigned. For the layerDefinitions section,

User joe has read-only permission
As indicated by nil, no users are specifically assigned read/write permission, although all users except joe have read/write permission by default

For the devices section,

User joe has read-only permission
User mary is specifically assigned read/write permission
All other users have read/write permission by default

For the constraints groups,

Users fred and jim have read-only permission
Users mary and bob are specifically assigned read/write permission
All other users have read/write permission by default

Because no other sections have permissions explicitly assigned, all users have read/write access to them.

Return to top

Virtuoso Technology Data SKILL ReferenceProduct Version IC23.1, June 2023