cr_cansee(9)

cr_cansee9

Determine visibility of objects given their user credentials

Usage

#include <sys/proc.h>

int

cr_cansee(struct ucred *u1, struct ucred *u2);

Overview

This function determines if a subject with credential u1 can see a subject or object associated to credential u2.

Specific types of subjects may need to submit to additional or different restrictions. As an example, for processes, see p_cansee(9), which calls this function.

The implementation relies on cr_bsd_visible(9) and consequently the sysctl(8) variables referenced in its manual page influence the result.

Return values

This function returns zero if the subject with credential u1 can “see” the subject or object with credential u2, or ESRCH otherwise.

Errors

[ESRCH]

The subject with credential u1 has been jailed and the subject or object with credential u2 does not belong to the same jail or one of its sub-jails, as determined by prison_check(9).

[ESRCH]

The MAC subsystem denied visibility.

[ESRCH]

cr_bsd_visible(9) denied visibility according to the BSD security policies in force.

Releases

46 releases since FreeBSD 6.3-RELEASE; the text changed 33 times.

  1. 6.3
  2. 6.4
  3. 7.0
  4. 7.1
  5. 7.2
  6. 7.3
  7. 7.4
  8. 8.0
  9. 8.1
  10. 8.2
  11. 8.3
  12. 8.4
  13. 9.0
  14. 9.1
  15. 9.2
  16. 9.3
  17. 10.0
  18. 10.1
  19. 10.2
  20. 10.3
  21. 10.4
  22. 11.0
  23. 11.1
  24. 11.2
  25. 11.3
  26. 11.4
  27. 12.0
  28. 12.1
  29. 12.2
  30. 12.3
  31. 12.4
  32. 13.0–13.2
  33. 13.3–14.2
  34. 14.3–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.