Index for Section 3

Alphabetical listing for G

getnetbyname(3)
NAME
  getnetbyname, getnetbyname_r - Get a network entry by name

LIBRARY
  Standard C Library (libc.so, libc.a)

SYNOPSIS
  #include <netdb.h>

  struct netent *getnetbyname(
	  const char *name);

  [Digital]  The following obsolete function is supported in order to
  maintain backward compatibility with previous versions of the operating
  system.  You should not use it in new designs.

  int getnetbyname_r(
	  const char *name,
	  struct netent *net,
	  struct netent_data *net_data);

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  getnetbyname():  XPG4-UNIX

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

PARAMETERS
  name	    Specifies the official network name or alias.

  net	    [Digital]  For getnetbyname_r() only, this points to the netent
	    structure.	The netdb.h header file defines the netent structure.

  net_data  [Digital]  For getnetbyname_r() only, this is data for the
	    networks database.	The netdb.h header file defines the
	    netent_data structure.

DESCRIPTION
  The getnetbyname() function returns a pointer to a structure of type
  netent. Its members specify data in fields from either the local
  /etc/networks file or the NIS distributed network database. To determine
  which file or files to search, and in which order, the system uses the
  switches in the /etc/svc.conf file.  The netdb.h header file defines the
  netent structure.

  The getnetbyname() function searches the networks file sequentially until a
  match with the name parameter occurs. When EOF (End-of-File) is reached
  without a match, an null pointer is returned by this function.


  Use the endnetent() function to close the networks file.

NOTES
  The getnetbyname() function returns a pointer to thread-specific data.
  Subsequent calls to this or a related function from the same thread
  overwrite this data.

  [Digital]  The getnetbyname_r() function is an obsolete reentrant version
  of the getnetbyname() function.  It is supported in order to maintain
  backward compatibility  with previous versions of the operating system and
  should not be used in new designs.  Note that you must set the net_fp field
  of the netent_data structure to NULL before its first access by either the
  setnetent_r() or getnetbyname_r() function.

  You must initialize the _net_stayopen flag of the netent_data structure if
  you are not using the setnetent() function.

RETURN VALUES
  Upon successful completion, the getnetbyname() function returns a pointer
  to a netent structure.  If it fails or reaches the end of the /etc/networks
  name file, it returns a null pointer.

  [Digital]  Upon successful completion, the getnetbyname_r() function stores
  the netent structure in the location pointed to by net, and returns a value
  of 0 (zero).	Upon failure, it returns a value of -1.

ERRORS
  Current industry standards do not define error values for the
  getnetbyname() function.

  [Digital]  If any of the following conditions occurs, the getnetbyname_r()
  function sets errno to the corresponding value:

  [EINVAL]  The net or net_data parameter is invalid.

  [ESRCH]   The search failed.

FILES
  /etc/networks
	    This file is the DARPA Internet network name database file. Each
	    record in the file occupies a single line and has three fields:
	    the official network name, the network number, and alias.

RELATED INFORMATION
  Functions: endnetent(3), getnetent(3), getnetbyaddr(3), setnetent(3).

  Files: networks(4), svc.conf(4).

  Networks: nis_intro(7).

  Standards: standards(5).