GETHOSTNAME(3)

명칭
gethostname, sethostname - 현재의 호스트의 이름의 취득 / 설정

프로그램 라이브러리
libc

서식
<unistd.h> int gethostname(char *name, int namelen) int sethostname(const char *name, int namelen)

해설
gethostname() 하 sethostname() 에 의해 전으로 설정된, 현재의 프로세서의 표준의 호스트명을 돌려줍니다. 파라미터 namelen 하 name 배열의 사이즈를 지정합니다. 사용할 수 있는 공간이 불충분한 경우를 제외해, 돌려주어지는 이름은 눌로 끝납니다.

sethostname() (은)는, 길이 namelen 의 name 그렇다고 하는, 호스트 머신명을 설정합니다. 이 호출은 슈퍼 유저로 한정되어 통상은 시스템의 bootstrap시에만 실행됩니다.

반환값

에러
이러한 호출에 의해, 다음의 에러가 돌아가는 경우가 있습니다.

[EFAULT]
    name 또는 namelen 파라미터가, 무효인 주소를 주었습니다.

[EPERM]
    호출원이 호스트명을 설정하려고 했습니다만, 슈퍼 유저가 아니었습니다.

관련 항목
gethostid(3), sysctl(3)

버그
호스트명의 길이가 MAXHOSTNAMELEN ( <sys/param.h> (으)로부터 취득) 캐릭터에 제한되어 있어, 현재의 설정은 256 캐릭터입니다. 이 캐릭터에는 말미의 눌 도 포함합니다.

역사
gethostname() 함수는, 4.2BSD 그리고 처음 등장했습니다.