hpux man page for priv_getbynum

priv_getbynum(3)					     Library Functions Manual						  priv_getbynum(3)

NAME
       priv_getbynum() - convert privilege ID to privilege name

SYNOPSIS
   Parameters
	      priv_id	The internal (numeric) representation of a privilege to be converted to the external (string) representation.

DESCRIPTION
       converts the internal privilege representation of the privilege ID to the external string representation.

RETURN VALUE
       returns the following values:

	      pointer	Successful  completion.  A non-null pointer to the privilege name is returned.	The returned string is a pointer to shared
			data, and must not be modified or freed.

	      NULL pointer
			Function failed.  is set to indicate the error.

ERRORS
       If fails, is set to one of the following values:

	      Invalid privilege ID.

EXAMPLES
	      #include <stdio.h>
	      #include <sys/privileges.h>
	      #include <sys/types.h>

	      main()
	      {
		      priv_t priv_id=PRIV_SYSNFS;
		      const char *priv_name;

		      priv_name = priv_getbynum(priv_id);
		      if (priv_name == NULL) {
			      printf("Error getting privilege name
");
		      } else {
			      /* priv_name is constant static data
				 may not be modified or freed */
			      printf("Privilege Name : %s
",priv_name);
		      }
	      }

SEE ALSO
       priv_getbyname(3), priv_set_to_str(3), priv_str_to_set(3), privileges(5).

																  priv_getbynum(3)