.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\"
.\" Updated with additions from Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.uk>
.\" Portions Copyright 1993 Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.uk>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH gethostid 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
gethostid, sethostid \- возвращает или назначает уникальный идентификатор
текущего узла
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <unistd.h>\fP
.PP
\fBlong gethostid(void);\fP
\fBint sethostid(long \fP\fIhostid\fP\fB);\fP
.fi
.PP
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBgethostid\fP():
.nf
.\"        || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
.\"        || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
    Since glibc 2.20:
        _DEFAULT_SOURCE || _XOPEN_SOURCE >= 500
    Up to and including glibc 2.19:
        _BSD_SOURCE || _XOPEN_SOURCE >= 500
.fi
.PP
\fBsethostid\fP():
.nf
.\"             commit 266865c0e7b79d4196e2cc393693463f03c90bd8
    начиная с glibc 2.21:
        _DEFAULT_SOURCE
    в glibc 2.19 и 2.20:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    до glibc 2.19, включительно:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
.fi
.SH ОПИСАНИЕ
\fBgethostid\fP()  and \fBsethostid\fP()  respectively get or set a unique 32\-bit
identifier for the current machine.  The 32\-bit identifier was intended to
be unique among all UNIX systems in existence.  This normally resembles the
Internet address for the local machine, as returned by \fBgethostbyname\fP(3),
and thus usually never needs to be set.
.PP
Только суперпользователь может вызывать \fBsethostid\fP().
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBgethostid\fP() возвращает 32\-битный идентификатор текущего узла,
установленный \fBsethostid\fP().
.PP
При успешном выполнении \fBsethostid\fP() возвращает 0; при ошибке — \-1, а в
\fIerrno\fP задаётся код ошибки.
.SH ОШИБКИ
Вызов \fBsethostid\fP() может завершиться со следующими ошибками:
.TP 
\fBEACCES\fP
Вызывающий не имеет прав на запись в файл, используемый для хранения ID
узла.
.TP 
\fBEPERM\fP
Эффективный идентификатор пользователя или группы вызывающего процесса не
совпадает с его соответствующим реальным идентификатором.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBgethostid\fP()
T}	Безвредность в нитях	T{
.na
.nh
MT\-Safe hostid env locale
T}
T{
.na
.nh
\fBsethostid\fP()
T}	Безвредность в нитях	T{
.na
.nh
MT\-Unsafe const:hostid
T}
.TE
.sp 1
.SH ВЕРСИИ
.\" libc5 used /etc/hostid; libc4 didn't have these functions
In the glibc implementation, the \fIhostid\fP is stored in the file
\fI/etc/hostid\fP.  (Before glibc 2.2, the file \fI/var/adm/hostid\fP was used.)
.PP
В реализации glibc, если \fBgethostid\fP() не может открыть файл, содержащий ID
узла, она получает имя узла с помощью \fBgethostname\fP(2), передаёт это имя
\fBgethostbyname_r\fP(3) для получения адреса IPv4 узла, и возвращает значение,
получаемое преобразованием битов полученного адреса IPv4 (такое значение
может быть не уникально).
.SH СТАНДАРТЫ
.TP 
\fBgethostid\fP()
POSIX.1\-2008.
.TP 
\fBsethostid\fP()
None.
.SH ИСТОРИЯ
4.2BSD; dropped in 4.4BSD.  SVr4 and POSIX.1\-2001 include \fBgethostid\fP()
but not \fBsethostid\fP().
.SH ДЕФЕКТЫ
Невозможно достоверно сказать, что идентификатор является глобально
уникальным.
.SH "СМ. ТАКЖЕ"
\fBhostid\fP(1), \fBgethostbyname\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
Vladislav <ivladislavefimov@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .