-
Notifications
You must be signed in to change notification settings - Fork 7
gethostname(2)
gethostname, sethostname - 호스트명 얻기/설정하기
#include <unistd.h>
int gethostname(char *name, size_t len);
int sethostname(const char *name, size_t len);glibc 기능 확인 매크로 요건 (feature_test_macros(7) 참고):
-
gethostname(): -
- glibc 2.12부터:
-
_BSD_SOURCE || _XOPEN_SOURCE >= 500
|| /* glibc 2.12부터: */ _POSIX_C_SOURCE >= 200112L
-
sethostname(): -
- 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)
이 시스템 호출들을 이용해 현재 프로세서의 호스트명에 접근하거나 변경한다.
sethostname()은 호스트명을 문자 배열 name에 준 값으로 설정한다. len 인자는 name의 바이트 수를 나타낸다. (즉 name에 종료용 널 바이트가 필요치 않다.)
gethostname()은 널로 끝나는 호스트명을 길이가 len 바이트인 문자 배열 name으로 반환한다. 그 널 종료 호스트명이 너무 긴 경우에는 이름이 잘리며 어떤 오류도 반환하지 않는다. (단 아래 NOTES 참고.) POSIX.1에서는 그런 절단이 발생하는 경우에 반환 버퍼에 종료용 널 바이트가 포함되는지 여부가 명세되어 있지 않다고 한다.
성공 시 0을 반환한다. 오류 시 -1을 반환하며 errno를 적절히 설정한다.
EFAULT-
name이 유효하지 않은 주소이다. EINVAL-
len이 음수이거나,sethostname()에서len이 허용 최대 길이보다 크다. ENAMETOOLONG- (glibc
gethostname())len이 실제 크기보다 작다. (버전 2.1 전에서 glibc는 이 경우에EINVAL을 사용한다.) EPERM-
sethostname()에서 호출자가 자기 UTS 네임스페이스에 연계된 사용자 네임스페이스에서CAP_SYS_ADMIN역능을 가지고 있지 않다. (namespaces(7) 참고.)
SVr4, 4.4BSD (4.2BSD에서 이 인터페이스들이 처음 등장). POSIX.1-2001과 POSIX.1-2008에서 gethostname()은 명세하지만 sethostname()은 명세하지 않는다.
SUSv2에서는 "호스트 이름이 255바이트로 제한된다"고 보장한다. POSIX.1에서는 "호스트 이름이 (종료용 널 바이트 포함하지 않음) HOST_NAME_MAX 바이트로 제한된다"고 보장한다. 리눅스에서 HOST_NAME_MAX는 64 값으로 정의돼 있으며 리눅스 1.0부터 그랬다. (그 전 커널에서는 제한값이 8바이트였다.)
GNU C 라이브러리에서는 gethostname() 시스템 호출을 이용하지 않는다. 대신 uname(2)을 호출해서 반환된 nodename 필드를 name으로 len 바이트까지 복사하는 라이브러리 함수로 gethostname()을 구현한다. 복사를 수행한 다음 그 함수에서는 nodename의 길이가 len과 같거나 그보다 큰지 확인하고, 그런 경우에는 errno를 ENAMETOOLONG으로 설정하고 -1을 반환한다. 이 경우 반환되는 name에 종료용 널 바이트가 포함되어 있지 않다.
glibc 버전 2.2 전에서는 nodename 길이가 len과 같거나 그보다 큰 경우를 다르게 처리한다. 함수에서 name으로 아무것도 복사하지 않고서 errno를 ENAMETOOLONG으로 설정하고 -1을 반환한다.
hostname(1), getdomainname(2), uname(2)
2017-09-15