


     ggggeeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee((((2222))))				      ggggeeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee((((2222))))



     NNNNAAAAMMMMEEEE
	  getdomainname, setdomainname - get/set name of current
	  domain

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  getdomainname(_n_a_m_e, _n_a_m_e_l_e_n)
	  char *_n_a_m_e;
	  int _n_a_m_e_l_e_n;

	  setdomainname(_n_a_m_e, _n_a_m_e_l_e_n)
	  char *_n_a_m_e;
	  int _n_a_m_e_l_e_n;


     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  ggggeeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee	returns	the name of the	domain for the current
	  processor, as	previously set by sssseeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee.  The
	  parameter _n_a_m_e_l_e_n specifies the size of the _n_a_m_e array.  The
	  returned name	is null-terminated unless insufficient space
	  is provided.

	  sssseeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee	sets the domain	of the host machine to be
	  _n_a_m_e,	which has length _n_a_m_e_l_e_n.  This	call is	restricted to
	  the super-user and is	normally used only when	the system is
	  bootstrapped.

	  The purpose of domains is to enable two distinct networks
	  that may have	host names in common to	merge.	Each network
	  would	be distinguished by having a different domain name.
	  At the current time, only the	yellow pages service makes use
	  of domains.

     RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
	  If the call succeeds a value of 0 is returned.  If the call
	  fails, then a	value of -1 is returned	and an error code is
	  placed in the	global location	errno.

     EEEERRRRRRRROOOORRRRSSSS
	  The following	errors may be returned by these	calls:

	  [[[[EEEEFFFFAAAAUUUULLLLTTTT]]]]	 The _n_a_m_e or _n_a_m_e_l_e_n parameter gave an invalid
			 address.

	  [[[[EEEEPPPPEEEERRRRMMMM]]]]	 The caller was	not the	super-user.

     BBBBUUUUGGGGSSSS
	  Domain names are limited to 255 characters.








     Page 1					   (last mod. 1/14/87)



