.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified 1995-07-22 by Michael Chastain : .\" 'gethostname' is real system call on Linux/Alpha. .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 2000-06-04, 2001-12-15 by aeb .\" Modified 2004-06-17 by mtk .\" Modified 2008-11-27 by mtk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH gethostname 2 "30 maart 2023" "Linux man\-pagina's 6.05.01" .SH NAAM gethostname, sethostname \- krijg/zet machinenaam .SH BIBLIOTHEEK Standard C bibliotheek (\fIlibc\fP, \fI\-lc\fP) .SH SAMENVATTING .nf \fB#include \fP .PP \fBint gethostname(char *\fP\fInaam\fP\fB, size_t \fP\fIlen\fP\fB);\fP \fBint sethostname(const char *\fP\fInaam\fP\fB, size_t \fP\fIlen\fP\fB);\fP .fi .PP .RS -4 Feature Test Macro´s eisen in glibc (zie \fBfeature_test_macros\fP(7)): .RE .PP \fBgethostname\fP(): .nf .\" The above is something of a simplification .\" also before glibc 2.3 there was a bit churn _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L || /* glibc 2.19 en eerder */ _BSD_SOURCE .fi .PP \fBsethostname\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 Vanaf glibc 2.21: _DEFAULT_SOURCE In glibc 2.19 en 2.20: _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) Tot en met glibc 2.19: _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) .fi .SH BESCHRIJVING Deze systeem aanroepen worden gebruikt om de machinenaam van het systeem op te vragen of te veranderen. Preciezer gezegd, ze werken op de machinenaam die geassocieerd is met de UTS naamruimte van het aanroepende proces. .PP \fBsethostname\fP() zet de machinenaam op de waarde gegeven door de tekenreeks \fInaam\fP. Het \fIlen\fP argument specificeert het aantal bytes in \fInaam\fP. (Daarom vereist \fInaam\fP geen afsluitend NULL byte.) .PP \fBgethostname\fP() retourneert een met NULL afgesloten machinenaam in de tekenreeks \fInaam\fP, die een lengte van \fIlen\fP bytes heeft. Als de met NULL afgesloten machinenaam te lang is om te passen, dan wordt de naam afgekapt, en geen fout teruggegeven (let op: lees OPMERKINGEN hieronder). POSIX.1 zegt dat als dit afkappen optreedt, dat het niet bepaald is of de teruggegeven buffer een afsluitende NULL bevat of niet. .SH "EIND WAARDE" Bij succes wordt nul teruggegeven. Bij falen wordt \-1 teruggegeven en wordt \fIerrno\fP overeenkomstig gezet. .SH FOUTEN .TP \fBEFAULT\fP \fInaam\fP is een ongeldig adres. .TP \fBEINVAL\fP .\" Can't occur for gethostbyname() wrapper, since 'len' has an .\" unsigned type; can occur for the underlying system call. \fIlen\fP is negatief of, voor \fBsethostname\fP(), \fIlen\fP is groter dat de maximum toegestane maat. .TP \fBENAMETOOLONG\fP (glibc \fBgethostname\fP()) \fIlen\fP is kleiner dan de benodigde grootte. (Voor glibc 2.1, gebruikte glibc in dit geval \fBEINVAL\fP.) .TP \fBEPERM\fP Met \fBsethostname\fP() had de aanroeper niet de benodigde \fBCAP_SYS_ADMIN\fP capaciteit in de gebruiker naamruimte geassocieerd met zijn UTS naamruimte (zie \fBnamespaces\fP(7)). .SH VERSIES SUSv2 garandeert dat "Machinenamen beperkt zijn tot 255 bytes". POSIX.1 garandeert dat "Machinenamen (exclusief het afsluitende NULL byte) beperkt zijn tot \fBHOST_NAME_MAX\fP bytes". Op Linux, is \fBHOST_NAME_MAX\fP is gedefinieerd met de waarde 64, hetgeen de limiet is geweest sinds Linux 1.0 (eerdere kernels kenden een limiet van 8 bytes). .SS "C library/kernel verschillen" De GNU C bibliotheek gebruikt de \fBgethostname\fP() systeem aanroep niet; in plaats daarvan implementeert hij \fBgethostname\fP() als een bibliotheek functie die \fBuname\fP(2) aanroept en vervolgens maximaal \fIlen\fP bytes van het teruggegeven \fInodenaam\fP veld naar \fInaam\fP kopieert. Na het uitvoeren van de kopie controleert de functie of de lengte van \fInodenaam\fP groter of gelijk was aan \fIlen\fP en als dat het geval was dan geeft de functie \-1 terug en wordt \fIerrno\fP gezet op \fBENAMETOOLONG\fP; in dit geval wordt het afsluitend NULL byte niet toegevoegd aan de teruggegeven \fInaam\fP. .SH "VOLDOET AAN" .TP \fBgethostname\fP() POSIX.1\-2008. .TP \fBsethostname\fP() Geen. .SH GESCHIEDENIS SVr4, 4.4BSD (deze functie verscheen voor het eerst in 4.2BSD).POSIX.1\-2001 en POSIX.1\-2008 bepalen \fBgethostname\fP(), maar niet \fBsethostname\fP(). .PP .\" At least glibc 2.0 and glibc 2.1, older versions not checked Versies van glibc voor 2.2 behandelden het geval waar de lengte van de \fInodenaam\fP groter of gelijk was aan \fIlen\fP anders: niets werd gekopieerd naar \fInaam\fP en de functie retourneert \-1 met \fIerrno\fP gezet op \fBENAMETOOLONG\fP. .SH "ZIE OOK" \fBhostname\fP(1), \fBgetdomainname\fP(2), \fBsetdomainname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7) .PP .SH VERTALING De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema , Mario Blättermann en Luc Castermans . .PP Deze vertaling is vrije documentatie; lees de .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID. .PP Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar .MT debian-l10n-dutch@lists.debian.org .ME .