Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TRIMDOMAIN(3)		    Library Functions Manual		 TRIMDOMAIN(3)

NAME
       trimdomain -- trim the current domain name from a host name

LIBRARY
       System Utilities	Library	(libutil, -lutil)

SYNOPSIS
       #include	<sys/types.h>
       #include	<libutil.h>

       void
       trimdomain(char *fullhost, int hostsize);

DESCRIPTION
       The  function  trimdomain()  removes  the  current domain name from the
       passed fullhost name by writing a NUL character over the	 first	period
       of  the	passed name.  The current domain name is determined by calling
       gethostname(3) and removing everything up to  the  first	 period.   The
       name is determined the first time this function is called and is	cached
       for future use.

       The  trimdomain() function will only trim the domain name if the	passed
       fullname	ends with the current domain name and if the length of the re-
       sulting host name does not exceed hostsize.

       If the passed fullname is actually a DISPLAY specification of the  form
       host.domain:nn[.nn] and the domain name is the same as the local	domain
       name,  trimdomain()  will  remove the embedded domain name, copying the
       screen and display numbers to the end of	the base host name and result-
       ing in host:nn[.nn].

RETURN VALUES
       The trimdomain()	function does not return a value.

SEE ALSO
       gethostname(3)

HISTORY
       The function trimdomain() first appeared	in FreeBSD 3.2.

FreeBSD	15.0			 April 7, 1999			 TRIMDOMAIN(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=trimdomain&sektion=3&manpath=FreeBSD+15.0-RELEASE+and+Ports>

home | help