utmp.h 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. /* Copyright (C) 1993-2020 Free Software Foundation, Inc.
  2. This file is part of the GNU C Library.
  3. The GNU C Library is free software; you can redistribute it and/or
  4. modify it under the terms of the GNU Lesser General Public
  5. License as published by the Free Software Foundation; either
  6. version 2.1 of the License, or (at your option) any later version.
  7. The GNU C Library is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  10. Lesser General Public License for more details.
  11. You should have received a copy of the GNU Lesser General Public
  12. License along with the GNU C Library; if not, see
  13. <https://www.gnu.org/licenses/>. */
  14. #ifndef _UTMP_H
  15. #define _UTMP_H 1
  16. #include <features.h>
  17. #include <sys/types.h>
  18. __BEGIN_DECLS
  19. /* Get system dependent values and data structures. */
  20. #include <bits/utmp.h>
  21. /* Compatibility names for the strings of the canonical file names. */
  22. #define UTMP_FILE _PATH_UTMP
  23. #define UTMP_FILENAME _PATH_UTMP
  24. #define WTMP_FILE _PATH_WTMP
  25. #define WTMP_FILENAME _PATH_WTMP
  26. /* Make FD be the controlling terminal, stdin, stdout, and stderr;
  27. then close FD. Returns 0 on success, nonzero on error. */
  28. extern int login_tty (int __fd) __THROW;
  29. /* Write the given entry into utmp and wtmp. */
  30. extern void login (const struct utmp *__entry) __THROW;
  31. /* Write the utmp entry to say the user on UT_LINE has logged out. */
  32. extern int logout (const char *__ut_line) __THROW;
  33. /* Append to wtmp an entry for the current time and the given info. */
  34. extern void logwtmp (const char *__ut_line, const char *__ut_name,
  35. const char *__ut_host) __THROW;
  36. /* Append entry UTMP to the wtmp-like file WTMP_FILE. */
  37. extern void updwtmp (const char *__wtmp_file, const struct utmp *__utmp)
  38. __THROW;
  39. /* Change name of the utmp file to be examined. */
  40. extern int utmpname (const char *__file) __THROW;
  41. /* Read next entry from a utmp-like file. */
  42. extern struct utmp *getutent (void) __THROW;
  43. /* Reset the input stream to the beginning of the file. */
  44. extern void setutent (void) __THROW;
  45. /* Close the current open file. */
  46. extern void endutent (void) __THROW;
  47. /* Search forward from the current point in the utmp file until the
  48. next entry with a ut_type matching ID->ut_type. */
  49. extern struct utmp *getutid (const struct utmp *__id) __THROW;
  50. /* Search forward from the current point in the utmp file until the
  51. next entry with a ut_line matching LINE->ut_line. */
  52. extern struct utmp *getutline (const struct utmp *__line) __THROW;
  53. /* Write out entry pointed to by UTMP_PTR into the utmp file. */
  54. extern struct utmp *pututline (const struct utmp *__utmp_ptr) __THROW;
  55. #ifdef __USE_MISC
  56. /* Reentrant versions of the file for handling utmp files. */
  57. extern int getutent_r (struct utmp *__buffer, struct utmp **__result) __THROW;
  58. extern int getutid_r (const struct utmp *__id, struct utmp *__buffer,
  59. struct utmp **__result) __THROW;
  60. extern int getutline_r (const struct utmp *__line,
  61. struct utmp *__buffer, struct utmp **__result) __THROW;
  62. #endif /* Use misc. */
  63. __END_DECLS
  64. #endif /* utmp.h */