Digital

NAME

X25BindFilter − Associates a filter with an X.25 listener

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x25.h>
int X25BindFilter(

int ld ,
char ∗ filter );

PARAMETERS

ldIdentifies the listener with which the filter is to be associated. 

filterPoints to a null-terminated string containing the name of the filter to be associated with the listener. 
 

DESCRIPTION

 
 
When a listener is created with the X25CreateListener routine, it has no filters associated with it.  The X25BindFilter routine associates a filter with an X.25 listener.  The filter specifies the name of an X.25 filter that is used to match incoming X.25 calls.  The X25BindFilter routine can be called multiple times to associate more than one filter with a single listener.  However, each filter can be associated with one listener only. 
 

RETURN VALUES

Upon successful completion, the X25BindFilter routine returns a value of 0.  Otherwise, a (negative) error code is returned. 
 

ERRORS

 
If the X25BindFilter routine fails, one of the following error codes is returned:

[X25RC_BADLD]
Invalid listener descriptor specified.

[X25RC_FILTERBUSY]
The requested filter is already associated with another listener. Each filter can be associated with a single listener only.

[X25RC_FILTERDEL]
One or more filters associated with this listener have been deleted by network management commands.  The X25BindFilter routine should be called again to associate a filter with the specified listener. 

[X25RC_INVALSTATE]
The port is not in a valid state to perform the requested operation. The most likely cause is that the port is a call port rather than a listener port.

[X25RC_LASTFILTER]
All filters associated with this listener have been deleted by network management commands.  The X25BindFilter routine should be called again to associate a filter with the specified listener. 

[X25RC_NOFILTER]
The specified filter does not exist.

[X25RC_NOMEM]
There were insufficient system resources to perform the requested operation.  The filter was not associated with the listener.

[X25RC_SERVICEDOWN]
The X.25 service is not available because an entity is not in the correct state.  Either the X25 Access entity is disabled, or the X25 Protocol entity does not exist.

[X25RC_SYSERR]
An operating system error occurred.  The external variable errno is set to indicate the error. 
 

RELATED INFORMATION

Functions: X25CreateListener(3X25), X25Listen(3X25), X25MakeCall(3X25), X25UnbindFilter(3X25). 

X.25 for Digital UNIX − Programmer’s Reference Manual.