Проект OpenNet: MAN net_kstat_create (9) Ядро (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

net_kstat_create (9)

>> net_kstat_create (9) ( Solaris man: Ядро )

NAME

net_kstat_create - create and initialize a new kstat for a specific instance of IP

SYNOPSIS

#include <sys/types.h>
#include <sys/kstat.h>
#include <sys/neti.h>

kstat_t *net_kstat_create(netid_t netid, char *module, 
    int instance, char *name, char *class, uchar_type type, 
    ulong_t ndata, uchar_t ks_flag);

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI).

PARAMETERS

netid

: IP instance identifier.

module

: The name of the provider's module (such as "sd", "esp", ...). The "core" kernel uses the name "unix".

instance

: The provider's instance number, as from ddi_get_instance(9F). Modules which do not have a meaningful instance number should use 0.

name

: A pointer to a string that uniquely identifies this structure. Only KSTAT_STRLEN - 1 characters are significant.

class

: The general class that this kstat belongs to. The following classes are currently in use: disk, tape, net, controller, vm, kvm, hat, streams, kstat, and misc.

type

The type of kstat to allocate. Valid types are:

KSTAT_TYPE_NAMED

: Allows more than one data record per kstat.

KSTAT_TYPE_INTR

: Interrupt; only one data record per kstat.

KSTAT_TYPE_IO

: I/O; only one data record per kstat

ndata

: The number of type-specific data records to allocate.

ks_flag

A bit-field of various flags for this kstat. ks_flag is some combination of:

KSTAT_FLAG_VIRTUAL

: Tells kstat_create() not to allocate memory for the kstat data section; instead, the driver will set the ks_data field to point to the data it wishes to export. This provides a convenient way to export existing data structures.

KSTAT_FLAG_WRITABLE

: Makes the kstat data section writable by root.

KSTAT_FLAG_PERSISTENT

: Indicates that this kstat is to be persistent over time. For persistent kstats, kstat_delete(9F) simply marks the kstat as dormant; a subsequent kstat_create() reactivates the kstat. This feature is provided so that statistics are not lost across driver close/open (such as raw disk I/O on a disk with no mounted partitions.) Note: Persistent kstats cannot be virtual, since ks_data points to garbage as soon as the driver goes away.

DESCRIPTION

The net_kstat_create() function allocates and initializes a kstat(9S) structure. See kstat_create(9F) for a complete discussion of this function.