tail head cat sleep
QR code linking to this page

Man page  — GETHOSTNAME

명칭

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

내용

프로그램 라이브러리

Standard C Library (libc, -lc)

서식

#include <unistd.h>

int
gethostname(char *name, int namelen);

int
sethostname(const char *name, int namelen);

해설

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

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

반환값

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

에러

이러한 호출에 의해, 다음의 에러가 돌아가는 경우가 있습니다.
[EFAULT]
  name 또는 namelen 파라미터가, 무효인 주소를 주었습니다.
[EPERM]
  호출원이 호스트명을 설정하려고 했습니다만, 슈퍼 유저가 아니었습니다.

관련 항목

gethostid(3), sysctl(3)

버그

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

역사

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

BSD 4.2 GETHOSTNAME (3) June 4, 1993

tail head cat sleep
QR code linking to this page


Ben Bullock이 유닉스 매뉴얼 페이지에서 서비스에 대한 의견을 주시기 바랍니다. Privacy policy.