]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/gethostid.3
fanotify_init.2, fanotify.7: Document FAN_REPORT_TID
[thirdparty/man-pages.git] / man3 / gethostid.3
index 0fc5025e48754623a787d27721fff5aef36765d7..4fef906cb82c9b684aab29a9f114260809381bd5 100644 (file)
 .\" %%%LICENSE_END
 .\"
 .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
-.TH GETHOSTID 3 2015-05-07 "Linux" "Linux Programmer's Manual"
+.TH GETHOSTID 3 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 gethostid, sethostid \- get or set the unique identifier of the current host
 .SH SYNOPSIS
 .B #include <unistd.h>
-.sp
+.PP
 .B long gethostid(void);
 .br
 .BI "int sethostid(long " hostid );
-.sp
+.PP
 .in -4n
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
-.sp
+.PP
 .ad l
 .br
 .BR gethostid ():
 .RS 4
-_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500
+.\"    || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 .RE
 .BR sethostid ():
-.RS 4
-_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500)
-.RE
+.nf
+    Since glibc 2.21:
+.\"             commit 266865c0e7b79d4196e2cc393693463f03c90bd8
+        _DEFAULT_SOURCE
+    In glibc 2.19 and 2.20:
+        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500)
+    Up to and including glibc 2.19:
+        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500)
+.fi
 .ad b
 .SH DESCRIPTION
 .BR gethostid ()
@@ -64,7 +70,7 @@ This normally resembles the Internet address for the local
 machine, as returned by
 .BR gethostbyname (3),
 and thus usually never needs to be set.
-
+.PP
 The
 .BR sethostid ()
 call is restricted to the superuser.
@@ -72,7 +78,7 @@ call is restricted to the superuser.
 .BR gethostid ()
 returns the 32-bit identifier for the current host as set by
 .BR sethostid ().
-
+.PP
 On success,
 .BR sethostid ()
 returns 0; on error, \-1 is returned, and
@@ -104,14 +110,14 @@ T{
 .BR sethostid ()
 T}     Thread safety   MT-Unsafe const:hostid
 .TE
-
+.sp 1
 .SH CONFORMING TO
 4.2BSD; these functions were dropped in 4.4BSD.
 SVr4 includes
 .BR gethostid ()
 but not
 .BR sethostid ().
-
+.PP
 POSIX.1-2001 and POSIX.1-2008 specify
 .BR gethostid ()
 but not
@@ -125,7 +131,7 @@ is stored in the file
 .I /var/adm/hostid
 was used.)
 .\" libc5 used /etc/hostid; libc4 didn't have these functions
-
+.PP
 In the glibc implementation, if
 .BR gethostid ()
 cannot open the file containing the host ID,