tcgetsid(3)

tcgetsid3

Get session id associated with a controlling terminal

Usage

#include <termios.h>

pid_t

tcgetsid(int fd);

Library

Standard C Library (libc, -lc)

Overview

The tcgetsid() function returns the process group ID of the session leader for a controlling terminal specified by fd.

Errors

If an error occurs, tcgetsid() returns -1 and the global variable errno is set to indicate the error, as follows:

[EBADF]

The fd argument is not a valid file descriptor.

[ENOTTY]

The calling process does not have a controlling terminal or the underlying terminal device represented by fd is not the controlling terminal.

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.1
  26. 13.2
  27. 13.3–16.0

Standards

The tcgetsid() function conforms to X/Open Portability Guide Issue 4, Version 2 (“XPG4.2”).

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