Describe a role

saf_describe_role is a function defined in role.c.

Synopsis:

int saf_describe_role(SAF_ParMode pmode, SAF_Role *role, char **name, char **url)

Formal Arguments:

  • role: Role to describe
  • name: If non-null, on return points to malloc’d role name if any
  • url: If non-null, on return points to malloc’d url if any

Description: Breaks role into its parts and returns them through pointers.

Preconditions:

  • role must be a valid role handle. (low-cost)

Return Value: A non-negative value indicates success, and a negative value indicates failure. On return, the output arguments name, url, and ID will be initialized.

See Also: