hpux man page for priv_getbyname

priv_getbyname(3)					     Library Functions Manual						 priv_getbyname(3)

NAME
       priv_getbyname() - convert privilege name to privilege ID

SYNOPSIS

   Parameters
       priv_name      pointer to the string containing the privilege name.

DESCRIPTION
       converts the external (string) representation of the privilege name to the internal (numeric) privilege representation.

RETURN VALUE
       returns the following values:

	      Successful completion.
		     The value of the privilege ID is returned.

	      Function failed.
		     is set to indicate the error.

ERRORS
       sets to the following value if the corresponding condition occurs.

       Invalid privilege name.

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

	      main()
	      {
		      priv_t privid;
		      char *privname = "SYSNFS";

		      privid = priv_getbyname(privname);
		      if (privid == -1) {
			      printf("
Error getting privilege ID
");
		      } else {
			      printf("
Privilege ID : %d
",privid);
		      }
	      }

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

																 priv_getbyname(3)