freenetconfigent()--Free the Netconfig Structure

 #include <netconfig.h>

 void freenetconfigent(struct netconfig *);

The freenetconfigent() function frees the netconfig structure that is returned from the call to the getnetconfigent() function.

Parameters

netconfig  (Input) 

A pointer to a netconfig structure that is set by a call to the setnetconfig() function.

Authorities

No authorization is required.

Return Value

None.

Error Conditions

If an exception occurs, freenetconfigent() fails to free the netconfig structure. If freenetconfigent() is not successful, errno indicates the following error.

Error Messages

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how freenetconfigent() is used:

#include <netconfig.h>

main()
{
 struct netconfig *nconf;

 /* Assuming UDP is a netid on the system, get the netconfig structure *
 if ((nconf = getnetconfigent("UDP")) == (struct netconfig *)NULL)
 {
   printf("There is no information about UDP\n");
   exit(1);
 }

 /* Print out the information associated with the transport */
 /* identified with the netid of UDP                        */
 printf("Transport provider name: %s\n", nconf->nc_netid);
    switch(nconf->nc_semantics)
    {
       case NC_TPI_CLTS:
          printf("Transport type name: TPI_CLTS\n");
          break;
       case NC_TPI_COTS:
          printf("Transport type name: TPI_COTS\n");
          break;
       case NC_TPI_COTS_ORD:
          printf("Transport type name: TPI_COTS_ORD\n");
          break;
       default:
          break;
    }
    switch(nconf->nc_flag)
    {
       case 0:
          printf("Transport flag name: N\n");
          break;
       case 1:
          printf("Transport flag name: V\n");
          break;
       default:
          break;
    }
 printf("Transport family name: %s\n", nconf->nc_protofmly);
 printf("Transport protocol name: %s\n", nconf->nc_proto);

 /* Free the netconfig structure returned by getnetconfigent() */
 freenetconfigent(nconf);
}