.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" 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 "10 oktober 2019" Linux "Linux Programmeurs Handleiding" .SH NAAM gethostname, sethostname \- krijg/zet machinenaam .SH SAMENVATTING \fB#include \fP .PP \fBint gethostname(char *\fP\fInaam\fP\fB, size_t \fP\fIlen\fP\fB);\fP .br \fBint sethostname(const char *\fP\fInaam\fP\fB, size_t \fP\fIlen\fP\fB);\fP .PP .RS -4 Test Macro´s in glibc (zie \fBfeature_test_macros\fP(7)): .RE .PP .ad l .PD 0 \fBgethostname\fP(): .RS 4 Sinds glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .br || /* Sinds glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200112L .RE .br \fBsethostname\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 Sinds 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 .PD .ad .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 version 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 "VOLDOET AAN" 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(). .SH OPMERKINGEN 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. .PP .\" At least glibc 2.0 and 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) .SH COLOFON Deze pagina is onderdeel van release 5.10 van het Linux \fIman\-pages\fP\-project. Een beschrijving van het project, informatie over het melden van bugs en de nieuwste versie van deze pagina zijn op \%https://www.kernel.org/doc/man\-pages/ te vinden. .SH VERTALING De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema , Mario Blättermann en Luc Castermans . 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. Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar .MT debian-l10n-dutch@lists.debian.org .ME .