publickey(3)

publickey3

Get public or secret key

Usage

#include <rpc/rpc.h>

#include <rpc/key_prot.h>

int

getpublickey(const char netname[MAXNETNAMELEN+1], char publickey[HEXKEYBYTES+1]);

int

getsecretkey(char netname[MAXNETNAMELEN+1], char secretkey[HEXKEYBYTES+1], char *passwd);

Library

library “librpcsvc”

Overview

These routines are used to get public and secret keys from the YP database. The getsecretkey() function has an extra argument, passwd, which is used to decrypt the encrypted secret key stored in the database. Both routines return 1 if they are successful in finding the key, 0 otherwise. The keys are returned as NUL-terminated, hexadecimal strings. If the password supplied to getsecretkey() fails to decrypt the secret key, the routine will return 1 but the secretkey argument will be a NUL string (“”).

Releases

77 releases since FreeBSD 3.0-RELEASE; the text changed 39 times.

  1. 3.0–3.4
  2. 3.5–3.5.1
  3. 4.0–4.2
  4. 4.3–4.4
  5. 4.5–4.11
  6. 5.0
  7. 5.1–6.3
  8. 6.4
  9. 7.0
  10. 7.1
  11. 7.2
  12. 7.3
  13. 7.4
  14. 8.0
  15. 8.1
  16. 8.2
  17. 8.3
  18. 8.4
  19. 9.0
  20. 9.1
  21. 9.2
  22. 9.3
  23. 10.0
  24. 10.1
  25. 10.2
  26. 10.3
  27. 10.4
  28. 11.0
  29. 11.1
  30. 11.2
  31. 11.3
  32. 11.4
  33. 12.0
  34. 12.1
  35. 12.2
  36. 12.3
  37. 12.4
  38. 13.0–13.2
  39. 13.3–14.5
  40. 15.0–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.