[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

tokdumpwrt Token-Ring Device Handler Entry Point

Purpose

Provides the means for a network dump program to transmit data to the token-ring device handler.

Syntax

#include <sys/device.h>
#include <sys/comio.h>
#include <sys/tokuser.h>
#include <sys/mbuf.h>
int tokdumpwrt 
(devno, m)
dev_t devno;
struct mbuf *m;

Parameters

devno Specifies major and minor device numbers.
m Pointer to an mbuf structure containing the data to be transmitted.

Description

The tokdumpwrt entry point can be called by a kernel-mode process to pass a write packet to the token-ring device handler for subsequent transmission. The address of this operation is provided to the kernel user by the dump user, who obtains it with the DUMPQUERY command.

The tokdumpwrt entry point provides for only one data packet to be transmitted for a single tokdumpwrt call. The tokdumpwrt entry point also assumes that the calling user is a valid kernel user and that the mbuf structure contains a valid data packet. It does not free the mbuf structure.

Execution Environment

The tokdumpwrt entry point can be called from the process or interrupt environment.

Return Values

ENODEV Indicates the specified minor number is not valid.
EAGAIN Indicates the transmit queue is full.

Implementation Specifics

The tokdumpwrt entry point functions with a Token-Ring High Performance Network Adapter that has been correctly configured for use on a qualified network. Consult the adapter specifications for more information on configuring the adapter and network qualifications.

Related Information

The tokdump entry point, tokmpx entry point, tokopen entry point.

The Memory Buffer (mbuf) Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]