ddi_getiminor(9f)

1ddi_getiminor(9F)        Kernel Functions for Drivers        ddi_getiminor(9F)
2
3
4

NAME

6       ddi_getiminor - get kernel internal minor number from an external dev_t
7

SYNOPSIS

9       #include <sys/types.h>
10       #include <sys/mkdev.h>
11       #include <sys/ddi.h>
12
13
14
15       minor_t ddi_getiminor(dev_t dev);
16
17

INTERFACE LEVEL

19       This interface is obsolete. getminor(9F) should be used instead.
20

PARAMETERS

22       The following parameters are supported:
23
24       dev    Device number.
25
26

DESCRIPTION

28       ddi_getiminor()  extracts  the  minor number from a device number. This
29       call should be used only for device numbers that have  been  passed  to
30       the  kernel  from  the user space through opaque interfaces such as the
31       contents of ioctl(9E) and putmsg(2). The device numbers passed in using
32       standard  device entry points must continue to be interpreted using the
33       getminor(9F) interface. This new interface is used to translate between
34       user  visible device numbers and in kernel device numbers. The two num‐
35       bers may differ in a clustered system.
36
37
38       For certain bus types, you can call this DDI  function  from  a   high-
39       interrupt  context.   These types include ISA and SBus buses.  See sys‐
40       bus(4), isa(4), and sbus(4) for details.
41

CONTEXT

43       ddi_getiminor() can be called from user context only.
44

RETURN VALUES

46       The minor number or EMINOR_UNKNOWN if the minor number of the device is
47       invalid.
48

ATTRIBUTES

50       See attributes(5) for a description of the following attributes:
51
52
53
54
55       ┌─────────────────────────────┬─────────────────────────────┐
56       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
57       ├─────────────────────────────┼─────────────────────────────┤
58       │Stability Level              │Obsolete                     │
59       └─────────────────────────────┴─────────────────────────────┘
60

WARNINGS

68       Drivers  are  required  to  replace  calls to ddi_getminor.9f by getmi‐
69       nor(9F)) in order to compile under Solaris 10 and later versions.
70
71
72
73SunOS 5.11                        18 Nov 2004                ddi_getiminor(9F)