gethostname 서브루틴

온라인 편집

용도

로컬 호스트의 이름을 가져옵니다.

라이브러리

표준 C 라이브러리(libc.a)

구문

#include <unistd.h>
  
int gethostname ( Name,  NameLength)
char *Name;
size_t NameLength;

설명

Gethostname 서브루틴은 로컬 호스트의 표준 호스트 이름을 검색합니다. 초과 공간이 제공되면 반환된 Name 매개변수는 널로 끝납니다. 공백이 충분하지 않으면 반환된 이름이 주어진 공백에 맞게 잘립니다. 시스템 호스트 이름은 256자로 제한됩니다.

Gethostname 서브루틴을 사용하면 호출 프로세스가 네트워크에 있는 컴퓨터의 내부 호스트 이름을 확인할 수 있습니다.

Gethostname 서브루틴이 포함된 모든 애플리케이션은 _BSD 매크로를 특정 값으로 설정하여 컴파일해야 합니다. 허용되는 값은 43과 44입니다. 그리고 모든 소켓 응용프로그램에는 BSD libbsd.a 라이브러리가 포함되어야 합니다.

매개변수

항목 설명
이름 호스트 이름을 저장할 바이트 배열의 주소를 지정합니다.
NameLength 이름 배열의 길이를 지정합니다.

리턴 값

성공적으로 완료되면 시스템은 0 값을 반환합니다.

Gethostname 서브루틴이 실패하면 서브루틴 핸들러는 다음 기능을 수행합니다:

  • 호출 프로그램에 -1 값을 반환합니다.
  • 특정 오류를 나타내는 오류 코드를 errno 전역 변수로 이동합니다.

오류 코드

다음과 같은 경우 gethostname 서브루틴은 성공하지 못합니다:

오류 설명
기본값 Name 매개변수 또는 NameLength 매개변수가 잘못된 주소를 제공합니다.