VxWorks Reference Manual : Libraries

netLib

NAME

netLib - network interface library

ROUTINES

netLibInit( ) - initialize the network package
netTask( ) - network task entry point

DESCRIPTION

This library contains the network task that runs low-level network interface routines in a task context. The network task executes and removes routines that were added to the job queue. This facility is used by network interfaces in order to have interrupt-level processing at task level.

The routine netLibInit( ) initializes the network and spawns the network task netTask( ). This is done automatically when the configuration macro INCLUDE_NETWORK is defined.

The routine netHelp( ) in usrLib displays a summary of the network facilities available from the VxWorks shell.

INCLUDE FILES

netLib.h

SEE ALSO

netLib, routeLib, hostLib, netDrv, netHelp( ), VxWorks Programmer's Guide: Network


Libraries : Routines

netLibInit( )

NAME

netLibInit( ) - initialize the network package

SYNOPSIS


STATUS netLibInit (void)

DESCRIPTION

This creates the network task job queue, and spawns the network task netTask( ). It should be called once to initialize the network. This is done automatically when the configuration macro INCLUDE_NETWORK is defined.

RETURNS

OK, or ERROR if network support cannot be initialized.

SEE ALSO

netLib, usrConfig, netTask( )


Libraries : Routines

netTask( )

NAME

netTask( ) - network task entry point

SYNOPSIS


void netTask (void)

DESCRIPTION

This routine is the VxWorks network support task. Most of the VxWorks network runs in this task's context.

NOTE

To prevent an application task from monopolizing the CPU if it is in an infinite loop or is never blocked, the priority of netTask( ) relative to an application may need to be adjusted. Network communication may be lost if netTask( ) is "starved" of CPU time. The default task priority of netTask( ) is 50. Use taskPrioritySet( ) to change the priority of a task.

This task is spawned by netLibInit( ).

RETURNS

N/A

SEE ALSO

netLibInit( )