man3/getutmp.3

   1 '\" t
   2 .\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk
   3 .\"     <mtk.manpages@gmail.com>
   4 .\"
   5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   6 .\"
   7 .TH getutmp 3 (date) "Linux man-pages (unreleased)"
   8 .SH NAME
   9 getutmp, getutmpx \- copy utmp structure to utmpx, and vice versa
  10 .SH LIBRARY
  11 Standard C library
  12 .RI ( libc ", " \-lc )
  13 .SH SYNOPSIS
  14 .nf
  15 .BR "#define _GNU_SOURCE" "             /* See feature_test_macros(7) */"
  16 .B #include <utmpx.h>
  17 .PP
  18 .BI "void getutmp(const struct utmpx *" ux ", struct utmp *" u );
  19 .BI "void getutmpx(const struct utmp *" u ", struct utmpx *" ux );
  20 .fi
  21 .SH DESCRIPTION
  22 The
  23 .BR getutmp ()
  24 function copies the fields of the
  25 .I utmpx
  26 structure pointed to by
  27 .I ux
  28 to the corresponding fields of the
  29 .I utmp
  30 structure pointed to by
  31 .IR u .
  32 The
  33 .BR getutmpx ()
  34 function performs the converse operation.
  35 .SH RETURN VALUE
  36 These functions do not return a value.
  37 .SH ATTRIBUTES
  38 For an explanation of the terms used in this section, see
  39 .BR attributes (7).
  40 .TS
  41 allbox;
  42 lbx lb lb
  43 l l l.
  44 Interface       Attribute       Value
  45 T{
  46 .na
  47 .nh
  48 .BR getutmp (),
  49 .BR getutmpx ()
  50 T}      Thread safety   MT-Safe
  51 .TE
  52 .sp 1
  53 .SH STANDARDS
  54 None.
  55 .SH HISTORY
  56 glibc 2.1.1.
  57 Solaris, NetBSD.
  58 .SH NOTES
  59 These functions exist primarily for compatibility with other
  60 systems where the
  61 .I utmp
  62 and
  63 .I utmpx
  64 structures contain different fields,
  65 or the size of corresponding fields differs.
  66 .\" e.g., on Solaris, the utmpx structure is rather larger than utmp.
  67 On Linux, the two structures contain the same fields,
  68 and the fields have the same sizes.
  69 .SH SEE ALSO
  70 .BR utmpdump (1),
  71 .BR getutent (3),
  72 .BR utmp (5)