tokdumpwrt Token-Ring Device Handler Entry Point

Purpose

Note: This function is supported in AIX® 5.1 and earlier only.

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

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.

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.

Execution Environment

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

Return Values