*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> getnetbyname_r (3)              
Title
Content
Arch
Section
 

getnetbyname(3)

Contents


NAME    [Toc]    [Back]

       getnetbyname, getnetbyname_r - Get a network entry by name

SYNOPSIS    [Toc]    [Back]

       #include <netdb.h>

       struct netent *getnetbyname(
               const char *name );

       [Tru64 UNIX]  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 );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

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

       getnetbyname():  XNS4.0, XNS5.0

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

PARAMETERS    [Toc]    [Back]

       Specifies  the  official  network  name  or alias.  [Tru64
       UNIX]  For  getnetbyname_r()  only,  this  points  to  the
       netent  structure.   The  netdb.h  header file defines the
       netent  structure.   [Tru64  UNIX]  For   getnetbyname_r()
       only, this is data for the networks database.  The netdb.h
       header file defines the netent_data structure.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

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

       [Tru64 UNIX]  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  option  of  the
       netent_data structure if you are not using the setnetent()
       function.

RETURN VALUES    [Toc]    [Back]

       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.

       [Tru64  UNIX]  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    [Toc]    [Back]

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

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

       The  net  or  net_data  parameter  is invalid.  The search
       failed.

FILES    [Toc]    [Back]

       This file is the 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.

SEE ALSO    [Toc]    [Back]

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

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

       Networks: nis_intro(7).

       Standards: standards(5).

       Network Programmer's Guide



                                                  getnetbyname(3)
[ Back ]
 Similar pages
Name OS Title
getnetent FreeBSD get network entry
endnetent FreeBSD get network entry
getnetent NetBSD get network entry
endnetent OpenBSD get network entry
setnetent OpenBSD get network entry
getnetbyaddr FreeBSD get network entry
getnetent IRIX get network entry
getnetbyname FreeBSD get network entry
setnetent FreeBSD get network entry
getnetent_r Tru64 Get a network entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service