This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

rsrcdbmgr_devno_attach()

Get major and minor device numbers

Synopsis:

#include <sys/rsrcdbmgr.h>
#include <sys/rsrcdbmsg.h>

dev_t rsrcdbmgr_devno_attach( const char * name,
                              int minor_request,
                              int flags );

Arguments:

name: The name of the class of devices that you want to get the major number for. This string can be anything, but various names are defined in in <sys/ftype.h>; see "Class names," below.
minor_request: The minor device number that you want to reserve, or -1 to let the system assign the next available minor number.
flags: Presently, there are no flags; pass zero for this argument.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The function rsrcdbmgr_devno_attach() reserves a device number that consists of:

a major number that corresponds to the given device class. If there isn't already a major number associated with the class, a new major number is assigned to it.
a minor number that's based on minor_request. If minor_request is -1, the function returns the first free minor number in the specified class.

There's a maximum of 64 major numbers (0 through 63) on the system, and a maximum of 1024 minor numbers (0 through 1023) per major number.

Major and minor numbers are used only by resource managers and are exposed through the rdev member of the iofunc_attr_t structure , and correspondingly the st_rdev member of the stat structure. They aren't required for proper operation; on simple devices, an entry will be simulated for you.

Class names

As mentioned about, the name of the class of devices can be anything. The following class names are defined in <sys/ftype.h>:

Constant	Value	Class
_MAJOR_PATHMGR	`"pathmgr"`	Used only by the path manager
_MAJOR_DEV	`"dev"`	Devices in `/dev` with only one instance (e.g. `/dev/tty`)
_MAJOR_BLK_PREFIX	`"blk-"`	All block devices (e.g. `/dev/hd[0-9]*` would be `"blk-hd"`)
_MAJOR_CHAR_PREFIX	`"char-"`	All character devices (e.g. `/dev/ser[0-9]*` would be `"char-ser"`)
_MAJOR_FSYS	`"fsys"`	All filesystems

Returns:

A dev_t object that contains the major and minor numbers, or -1 if an error occurs (errno is set).

You can extract the major and minor number values from the dev_t object by using the major() and minor() macros defined in <sys/types.h>. For more information, see the documentation for stat().

Errors:

EINVAL: Invalid argument.

Examples:

#include <sys/rsrcdbmgr.h>
#include <sys/rsrcdbmsg.h>

char      *dev_name;
int       myminor_request, flags=0;
dev_t     major_minor;

major_minor = rsrcdbmgr_devno_attach
              ( dev_name, myminor_request, flags );

...

rsrcdbmgr_devno_detach( major_minor, flags );

Classification:

QNX Neutrino

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes

Caveats:

If your application calls this function, it must run as root.