VxWorks API Reference : OS 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 INCLUDE_NET_LIB 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

routeLib, hostLib, netDrv, netHelp( ),


OS 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 INCLUDE_NET_LIB is defined.

VXWORKS AE PROTECTION DOMAINS

Under VxWorks AE, you can call this function from within the kernel protection domain only. This restriction does not apply under non-AE versions of VxWorks.

RETURNS

OK, or ERROR if network support cannot be initialized.

SEE ALSO

netLib, usrConfig, netTask( )


OS 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( ).

VXWORKS AE PROTECTION DOMAINS

Under VxWorks AE, you can call this function from within the kernel protection domain only. This restriction does not apply under non-AE versions of VxWorks.

RETURNS

N/A

SEE ALSO

netLib, netLibInit( )