man pages section 9: DDI and DKI Kernel Functions

Exit Print View

Updated: July 2014
 
 

pci_plist_lookup_int32_array(9F)

Name

pci_plist_lookup, pci_plist_lookup_int8, pci_plist_lookup_uint8, pci_plist_lookup_int16, pci_plist_lookup_uint16, pci_plist_lookup_int32, pci_plist_lookup_uint32, pci_plist_lookup_int64, pci_plist_lookup_uint64, pci_plist_lookup_string, pci_plist_lookup_plist, pci_plist_lookup_int8_array, pci_plist_lookup_uint8_array, pci_plist_lookup_int16_array, pci_plist_lookup_uint16_array, pci_plist_lookup_int32_array, pci_plist_lookup_uint32_array, pci_plist_lookup_int64_array, pci_plist_lookup_uint64_array, pci_plist_lookup_string_array - name-value pair lookup functions

Synopsis

#include <sys/sunddi.h>

int pci_plist_lookup_int8(pci_plist_t plist, const char *name,
     int8_t *val);
int pci_plist_lookup_uint8(pci_plist_t plist, const char *name,
     uint8_t *val);
int pci_plist_lookup_int16(pci_plist_t plist, const char *name,
     int16_t *val);
int pci_plist_lookup_uint16(pci_plist_t plist, const char *name,
     uint16_t *val);
int pci_plist_lookup_int32(pci_plist_t plist, const char *name,
     int32_t *val);
int pci_plist_lookup_uint32(pci_plist_t plist, const char *name,
     uint32_t *val);
int pci_plist_lookup_int64(pci_plist_t plist, const char *name,
     int64_t *val);
int pci_plist_lookup_uint64(pci_plist_t plist, const char *name,
     uint64_t *val);
int pci_plist_lookup_string(pci_plist_t plist, const char *name,
     char **val);
int pci_plist_lookup_plist(pci_plist_t plist, const char *name,
     pci_plist_t **val);
int pci_plist_lookup_int8_array(pci_plist_t plist, const char *name,
     int8_t *val, uint_t *nelem);
int pci_plist_lookup_uint8_array(pci_plist_t plist, const char *name,
     uint8_t *val, uint_t *nelem);
int pci_plist_lookup_int16_array(pci_plist_t plist, const char *name,
     int16_t *val, uint_t *nelem);
int pci_plist_lookup_uint16_array(pci_plist_t plist, const char *name,
     uint16_t *val, uint_t *nelem);
int pci_plist_lookup_int32_array(pci_plist_t plist, const char *name,
     int32_t *val, uint_t *nelem);
int pci_plist_lookup_uint32_array(pci_plist_t plist, const char *name,
     uint32_t *val, uint_t *nelem);
int pci_plist_lookup_int64_array(pci_plist_t plist, const char *name,
     int64_t *val, uint_t *nelem);
int pci_plist_lookup_uint64_array(pci_plist_t plist, const char *name,
     uint64_t *val, uint_t *nelem);
int pci_plist_lookup_string_array(pci_plist_t plist, const char *name,
     char **val, uint_t *nelem);

Parameters

plist

A handle obtained from pci_plist_get(9F) or pci_plist_getvf(9F).

name

Name of the name-value pair to search

nelem

Address to store the number of elements in value

val

Address to store the starting address of the value

Description

These functions find the nvpair (name-value pair) that matches the name and type as indicated by the interface name. If one is found, nelem and val are modified to contain the number of elements in value and the starting address of data, respectively.

Return Values

These functions return 0 on success and an error value on failure.

Errors

These functions will fail if:

DDI_EINVAL

There is an invalid argument.

ENOENT

No matching name-value pair is found

ENOTSUP

An encode/decode method is not supported.

Context

These functions can be called from kernel non-interrupt context.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Uncommitted

See Also

attributes(5), pci_plist_get(9F), pci_plist_getvf(9F), pciv_vf_config(9F), pci_param_get_ioctl(9F)