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)