<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> 
<chapter lang=ko> 
<!-- 작성자 : yundream             --> 
<!-- 작성일 : 2005/08/01           --> 
<!-- 연락처 : yundream@joinc.co.kr --> 
 
<!-- 함수 이름을 입력합니다 --> 
<title>gethostname(3)</title> 
 
<!-- 이건 함수에 대한 대략적인 설명이구요 --> 
<para> 
    호스트 이름을 얻어오거나 설정한다. 
</para> 
  
<!-- 여기에 함수의 간단한 사용법이 들어갑니다 --> 
<section> 
    <title>사용법</title> 
    <para> 
        <screen> 
#include <unistd.h> 
 
int gethostname(char *name, size_t len); 
int sethostname(const char *name, size_t len); 
        </screen> 
    </para> 
</section> 
 
<!-- 여기엔 함수의 자세한 설명 이 들어갑니다 --> 
<section> 
    <title>설명</title> 
    <para> 
        이 함수는 현재 프로세스의 호스트이름을 가져오거나 변경하기 위해서  
        사용한다. gethostname() 함수는 호스트이름을 가져온다. len은 가져올  
        name의 최대 길이를 지정하기 위해서 사용한다.  
    </para> 
</section> 
 
<!-- 함수가 되돌려주는 값이구요 --> 
<section> 
    <title>반환값</title> 
    <para> 
        성공하면 0을 실패하면 -1을 리턴하고, 적당한 errno를 설정한다. 
    </para> 
</section> 
 
<!-- 에러가 발생했을때 되돌려주는 값들입니다 --> 
<section> 
    <title>에러</title> 
    <para> 
        <variablelist>     
            <varlistentry> 
            <term>EINVAL</term>  
            <listitem> 
                <para>     
                    sethostname을 적용하는데 있어서 len이 음의 정수이거나, 
                    len이 허용된 크기를 넘었을 경우. 
                </para>     
            </listitem> 
            </varlistentry> 
            <varlistentry> 
            <term>EPERM</term>  
            <listitem> 
                <para>     
                    sethostname은 루트권한을 가지고 있어야 한다. 
                </para>     
            </listitem> 
            </varlistentry> 
            <varlistentry> 
            <term>EFAULT</term>  
            <listitem> 
                <para>     
                    <emphasis>name</emphasis>이 잘못된 주소영역을 가리키고 있다. 
                </para>     
            </listitem> 
            </varlistentry> 
        </variablelist>     
    </para> 
</section> 
 
<!-- 마지막으로 에제 입니다                                                 --> 
<!-- 여기에는 완전한 예제가 들어가 있는데, 굳이 완전한 예제를 만들필요 없이 --> 
<!-- 코드 일부분만 작성해서 올려주셔도 됩니다                               -->  
<!-- "<", ">", "&" 등은 변환해 주셔야 하는데, 귀찮으시면 :-) 변환 하지 않   --> 
<!-- 아도 됩니다. 제가 검사 해서 올리겠습니다                               --> 
<!-- 예제에 대한 간단한 설명을 적어주셔도 되구요                            --> 
<section> 
    <title>예제</title> 
    <para> 
        <screen> 
#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); 
}  
        </screen> 
    </para> 
</section> 
</chapter>