JavaScript-1.5 Reference

JSPrincipals

Data Structure

Summary

Defines security information for an object or script.

Syntax

typedef struct JSPrincipals {
    char *codebase;
    void *(*getPrincipalArray)(JSContext *cx,
       struct JSPrincipals *);
    JSBool (*globalPrivilegesEnabled)(JSContext *cx,
       struct JSPrincipals *);
    uintN refcount;
    void (*destroy)(JSContext *cx, struct JSPrincipals *);
} JSPrincipals;

Name	Type	Description
`*codebase`	`char`	Pointer to the codebase for the principal.
`*getPrincipalArray`	`void`	Pointer to the function that returns an array of principal definitions.
`*globalPrivilegesEnabled`	`JSBool`	Flag indicating whether principals are enabled globally.
`refcount`	`uintN`	Reference count for the principals. Each reference to a principal increments refcount by one. As principals references are dropped, call the `destroy` method to decrement the reference count and free the principals if they are no longer needed.
`*destroy`	`void`	Pointer to the function that decrements the reference count and possibly frees the principals if they are no longer in use.

Description

JSPrincipals is a structure that defines the connection to security data for an object or script. Security data is defined independently of the JS engine, but is passed to the engine through the JSPrincipals structure. This structure is passed as an argument to versions of API calls that compile and evaluate scripts and functions that depend on a security model. Some examples of security-enhanced API call are JS_CompileScriptForPrincipals, JS_CompileFunctionForPrincipals, and JS_EvaluateScriptForPrincipals.

codebase points to the common codebase for this object or script. Only objects and scripts that share a common codebase can interact.

getPrincipalArray is a pointer to the function that retrieves the principals for this object or script.

globalPrivilegesEnabled is a flag that indicates whether principals are enabled globally.

refcount is used to maintain active principals. Each time an object is referenced, refcount must be increased by one. Each time an object is dereferenced, refcount must be decremented by one. When refcount is zero, the principals are no longer in use and are destroyed. Use the JSPRINCIPALS_HOLD macro to increment refcount, and use JS_PRINCIPALS_DROP to decrement refcount.

JavaScript-1.5 Reference

Summary

Syntax

Description

See Also