rpc_gss_get_principal_name(3)

rpc_gss_get_principal_name3

Get a principal name

Usage

#include <rpc/rpcsec_gss.h>

bool_t

rpc_gss_get_principal_name(rpc_gss_principal_t *principal, const char *mech, const char *name, const char *node, const char *domain);

Library

library “librpcsec_gss”

Overview

This function can be used to generate a client principal name from various strings.

Parameters

principal

If the principal is created successfully, *principal will be set to point at the new principal in GSS-API exported name form

mech

The name of the mechanism for this principal

name

The name part of the principal

node

If non-null, the hostname or instance part of the principal

domain

If non-null, the domain or realm part of the principal

Return values

Returns TRUE if the principal was created or FALSE otherwise

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 26 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0–13.2
  26. 13.3–13.5
  27. 14.0–16.0

History

The rpc_gss_get_principal_name function first appeared in FreeBSD 8.0.

Authors

This manual page was written by Doug Rabson ⟨[email protected]⟩.

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