메뉴

문서정보

Docbook 원문

gethostname(3)

1장. gethostname(3)

차례
1.1. 사용법
1.2. 설명
1.3. 반환값
1.4. 에러
1.5. 예제

호스트 이름을 얻어오거나 설정한다.


1.1. 사용법

#include <unistd.h>

int gethostname(char *name, size_t len);
int sethostname(const char *name, size_t len);
        


1.2. 설명

이 함수는 현재 프로세스의 호스트이름을 가져오거나 변경하기 위해서 사용한다. gethostname() 함수는 호스트이름을 가져온다. len은 가져올 name의 최대 길이를 지정하기 위해서 사용한다.


1.3. 반환값

성공하면 0을 실패하면 -1을 리턴하고, 적당한 errno를 설정한다.


1.4. 에러

EINVAL

sethostname을 적용하는데 있어서 len이 음의 정수이거나, len이 허용된 크기를 넘었을 경우.

EPERM

sethostname은 루트권한을 가지고 있어야 한다.

EFAULT

name이 잘못된 주소영역을 가리키고 있다.


1.5. 예제

#include <unistd.h>
#include <stdio.h>

int main(int argc, char **argv)
{
	char name[256] = {0x00,};
	int len=256;
	gethostname(name, len);
	printf("%s\n",name);
}