gethostname

Autres langues

Langue: ja

Version: 2004-06-17 (openSuse - 09/10/07)

Section: 2 (Appels système)

̾Á°

gethostname, sethostname - ¥Û¥¹¥È̾¤Î¼èÆÀ¡¦ÀßÄê¤ò¤¹¤ë

½ñ¼°

#include <unistd.h>

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

ÀâÌÀ

¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¸½ºß¤Î¥×¥í¥»¥Ã¥µ¤Î¥Û¥¹¥È̾¤ò¼èÆÀ¡¦Êѹ¹¤¹¤ë¤¿¤á¤Ë »ÈÍѤµ¤ì¤ë¡£ gethostname() ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢(°ÊÁ°¤Ë sethostname() ¤ÇÀßÄꤵ¤ì¤¿) NULL ½ªÃ¼¤µ¤ì¤¿¥Û¥¹¥È̾¤ò¡¢ Ťµ len ¥Ð¥¤¥È¤ÎÇÛÎó name ¤ËÊÖ¤¹¡£ ÇÛÎó¤ÎŤµ¤¬ NULL ½ªÃ¼¤µ¤ì¤¿¥Û¥¹¥È̾¤Ë­¤ê¤Ê¤¤¾ì¹ç¡¢ ¥¨¥é¡¼¤ÏÊÖ¤µ¤ì¤Ê¤¤¤¬¡¢¥Û¥¹¥È̾¤ÏÀÚ¤êµÍ¤á¤é¤ì¤ë¡£ ÀÚ¤êµÍ¤á¤é¤ì¤¿¥Û¥¹¥È̾¤¬ NULL ½ªÃ¼¤µ¤ì¤ë¤«¤É¤¦¤«¤Ï»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¡£

ÊÖ¤êÃÍ

À®¸ù¤·¤¿¾ì¹ç 0 ¤¬Ê֤롣¼ºÇÔ¤·¤¿¾ì¹ç -1 ¤¬Ê֤ꡢ errno ¤¬¥¨¥é¡¼¤ÎÆâÍƤ˽¾¤Ã¤ÆÀßÄꤵ¤ì¤ë¡£

¥¨¥é¡¼

EFAULT
name ¤¬ÉÔÀµ¤Ê¥¢¥É¥ì¥¹¤Ç¤¢¤ë¡£
EINVAL
len ¤¬Éé¤Ç¤¢¤ë¡£¤Þ¤¿¤Ï¡¢ sethostname() ¤Ë¤ª¤¤¤Æ len ¤¬µöÍƤµ¤ì¤¿ºÇÂ祵¥¤¥º¤ò±Û¤¨¤Æ¤¤¤ë¡£ ¤Þ¤¿¤Ï¡¢Linux/i386 ¤Î gethostname() ¤Ë¤ª¤¤¤Æ len ¤¬¼ÂºÝ¤ÎÃͤè¤ê¤â¾®¤µ¤¤ (ºÇ¸å¤Î¥±¡¼¥¹¤Ç¤Ï¡¢glib 2.1 ¤À¤È ENAMETOOLONG ¤¬ÊÖ¤µ¤ì¤ë)¡£
EPERM
sethostname() ¤Ë¤ª¤¤¤Æ¡¢¸Æ¤Ó½Ð¤·¤¿¿Í¤¬ CAP_SYS_ADMIN ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability) ¤ò»ý¤Ã¤Æ¤¤¤Ê¤«¤Ã¤¿¡£

½àµò

SVr4, 4.4BSD (¤³¤ì¤é¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï 4.2BSD ¤Ç½é¤á¤ÆÅо줷¤¿)¡£ POSIX.1-2001 ¤Ç¤Ï gethostname() ¤Ë¤Ä¤¤¤Æ¤Ïµ¬Äꤷ¤Æ¤¤¤ë¤¬¡¢ sethostname() ¤Ïµ¬Äꤷ¤Æ¤¤¤Ê¤¤¡£

Ãí°Õ

SUSv2 ¤Ç¤Ï¡Ö¥Û¥¹¥È̾¤¬ 255 ¥Ð¥¤¥È¤ËÀ©¸Â¤µ¤ì¤ë¡×¤³¤È¤òÊݾڤ·¤Æ¤¤¤ë¡£ POSIX.1-2001 ¤Ç¤Ï¡Ö¥Û¥¹¥È̾ (½ªÃ¼¤Î NULL ¥Ð¥¤¥È¤Ï´Þ¤Þ¤Ê¤¤) ¤¬ HOST_NAME_MAX ¥Ð¥¤¥È¤ËÀ©¸Â¤µ¤ì¤ë¡×¤³¤È¤òÊݾڤ·¤Æ¤¤¤ë¡£

glibc ¤Ç¤ÎÃí°Õ

GNU C ¥é¥¤¥Ö¥é¥ê¤Ï¡¢ gethostname() ¤ò¥é¥¤¥Ö¥é¥ê´Ø¿ô¤È¤·¤Æ¼ÂÁõ¤·¤Æ¤ª¤ê¡¢ ¤³¤Î´Ø¿ô¤Ï uname(2) ¤ò¸Æ¤Ó½Ð¤·¡¢ uname(2) ¤¬ÊÖ¤·¤¿ nodename ¥Õ¥£¡¼¥ë¥É (¤ÎºÇÂç len ¥Ð¥¤¥È) ¤ò name ¤Ë¥³¥Ô¡¼¤¹¤ë¡£ ¥³¥Ô¡¼¤ò¹Ô¤Ã¤¿ºÝ¤Ë¡¢¤³¤Î´Ø¿ô¤Ï nodename ¤ÎŤµ¤¬ len °Ê¾å¤«¤Î³Îǧ¤ò¹Ô¤¤¡¢ len °Ê¾å¤Î¾ì¹ç¤Ë¤Ï -1 ¤òÊÖ¤·¡¢ errno ¤Ë ENAMETOOLONG ¤òÀßÄꤹ¤ë¡£ ¥Ð¡¼¥¸¥ç¥ó 2.2 ¤è¤êÁ°¤Î glibc ¤Ç¤Ï¡¢ nodename ¤ÎŤµ¤¬ len °Ê¾å¤Î¾ì¹ç¤Î°·¤¤¤¬°Û¤Ê¤ë; len °Ê¾å¤Î¾ì¹ç¤Ë¤Ï¡¢ name ¤Ë¤Ï²¿¤â¥³¥Ô¡¼¤»¤º¡¢´Ø¿ô¤Ï -1 ¤òÊÖ¤·¡¢ errno ¤Ë ENAMETOOLONG ¤òÀßÄꤹ¤ë¡£

´ØÏ¢¹àÌÜ

getdomainname(2), setdomainname(2), uname(2)