di_prop_lookup_bytes(3devinfo) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

di_prop_lookup_bytes(3devinfo)

di_...tes(3DEVINFO)  Device Information Library Functions  di_...tes(3DEVINFO)

NAME
       di_prop_lookup_bytes,     di_prop_lookup_ints,    di_prop_lookup_int64,
       di_prop_lookup_strings, di_prop_exists - search for a property

SYNOPSIS
       cc [ flag... ] file... -ldevinfo [ library... ]
       #include <libdevinfo.h>

       int di_prop_lookup_bytes(dev_t dev, di_node_t node,
            const char *prop_name, uchar_t **prop_data);


       int di_prop_lookup_ints(dev_t dev, di_node_t node,
            const char *prop_name, int **prop_data);


       int di_prop_lookup_int64(dev_t dev, di_node_t node,
            const char *prop_name, int64_t **prop_data);


       int di_prop_lookup_strings(dev_t dev, di_node_t node,
            const char *prop_name, char **prop_data);


       int di_prop_exists(dev_t dev, di_node_t node,
            const char *prop_name);

PARAMETERS
       dev          dev_t of minor node with which the property is associated.
                    DDI_DEV_T_ANY is a wild card that matches all dev_t's, in‐
                    cluding DDI_DEV_T_NONE.


       node         Handle to the device node with which the property is asso‐
                    ciated.


       prop_data    For di_prop_lookup_bytes(), the address to a pointer to an
                    array of unsigned characters containing the property data.

                    For di_prop_lookup_ints(), the address to a pointer to  an
                    array of integers containing the property data.

                    For di_prop_lookup_int64(), the address to a pointer to an
                    array of 64-bit integers containing the property data.

                    For  di_prop_lookup_strings(), the address to a pointer to
                    a buffer containing  a  concatenation  of  null-terminated
                    strings containing the property data.


       prop_name    Name of the property for which to search.


DESCRIPTION
       These  functions  return  the  value  of a known property name type and
       dev_t value. All memory allocated by these functions is managed by  the
       library and must not be freed by the caller.

RETURN VALUES
       If  the  property  is  found, the number of entries in prop_data is re‐
       turned. If the property is a boolean type, 0 is returned and the  exis‐
       tence  of  this  property indicates the value is true. Otherwise, -1 is
       returned and errno is set to indicate the error.


       The ddi_prop_exists() returns 1 if  a  property,  including  a  boolean
       property, exists, and 0 otherwise.

ERRORS
       These functions will fail if:

       EINVAL     Invalid argument.


       ENOTSUP    The snapshot contains no property information.


       ENXIO      The property does not exist; try di_prom_prop_lookup_*().


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSafe


SEE ALSO
       di_init(3DEVINFO),     di_prom_prop_lookup_bytes(3DEVINFO),     libdev‐
       info(3LIB), attributes(7)


       Writing Device Drivers in Oracle Solaris 11.4

Oracle Solaris 11.4               3 Jul 2012               di_...tes(3DEVINFO)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3