procmgr_ability_lookup()

Arguments:

name

The name of the ability. This should by convention consist of a service identifier followed by a capability identifier (e.g., "fs-qnx6/some_devctl").

Library:

libc

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

Description:

The procmgr_ability_lookup() function looks up a process-manager ability that was (or will be) created by a call to procmgr_ability_create().

In QNX Neutrino 7.0 or later, if the ability hasn't yet been created:

• If your process has the PROCMGR_AID_ABLE_CREATE ability enabled (see procmgr_ability()), procmgr_ability_lookup() creates the ability and returns a permanent identifier for it.
• If your process doesn't have the PROCMGR_AID_ABLE_CREATE ability enabled, procmgr_ability_lookup() returns a temporary identifier that includes the PROCMGR_AID_UNCREATED bit. You can use the temporary identifier with ConnectClientInfoAble() (which will see if the ability has been created and give you a permanent identifier), but not with procmgr_ability(). You can call procmgr_ability_lookup() again later, in the hope that the ability has been created and so will have a permanent identifier.

Current custom abilities

The currently defined custom abilities are listed below.

• The filesystem event manager (fsevmgr) uses the following:

  Name	Constant
  fsevmgr/qnxext	INOTIFY_ABILITY_QNX_EXT
  fsevmgr/recurse	INOTIFY_ABILITY_RECURSE

  For more information, see inotify_qnx_ext().

• The audio service uses the following:

  Name	Constant
  ioaudio/capturerestricted	IOAUDIO_ABILITY_RESTRICTED_CAPTURE
  ioaudio/playbackrestricted	IOAUDIO_ABILITY_RESTRICTED_PLAYBACK

  For more information, see io-audio in the Utilities Reference.

• The resource manager library creates the following:

  Name	Constant
  iofunc/chown	IOFUNC_ABILITY_CHOWN
  iofunc/dup	IOFUNC_ABILITY_DUP
  iofunc/exec	IOFUNC_ABILITY_EXEC
  iofunc/read	IOFUNC_ABILITY_READ

  For more information, see “Security” in the “Fleshing Out the Skeleton” chapter of Writing a Resource Manager.

• The General Purpose Input/Output (GPIO) system uses the following:

  Name	Constant
  io-gpio/all	—

• The io-pkt manager uses the following:

  Name	Constant
  network/bind/privport	_IOPKT_ABILITY_NW_BIND_PRIVPORT
  network/interface/getpriv	_IOPKT_ABILITY_NW_INTERFACE_GETPRIV
  network/interface/setpriv	_IOPKT_ABILITY_NW_INTERFACE_SETPRIV
  network/route/set	_IOPKT_ABILITY_NW_ROUTE_SET
  network/socket/rawsock	_IOPKT_ABILITY_NW_SOCKET_RAWSOCK

  For more information, see “Process manager abilities” in the “Overview” chapter of the Core Networking Stack User's Guide.

• The smmuman service uses the following:

  Name	Constant
  smmu/attach	SMMU_ABILITY_ATTACH_NAME
  smmu/target	SMMU_ABILITY_TARGET_NAME

  For more information, see the SMMUMAN User's Guide.

• The block I/O system uses most of the following abilities to govern the use of some devctl() commands:

  Name	Constant	Operation
  vfs/fs-control	BLK_ABILITY_FSCTL	DCMD_FSYS_CTL
  vfs/hook-control	BLK_ABILITY_HOOKCTL	DCMD_FSYS_HOOK_CTL
  vfs/mount-blk	BLK_ABILITY_MOUNTVFS	mount, umount
  vfs/pregrow	BLK_ABILITY_PREGROW	DCMD_FSYS_PREGROW_FILE
  vfs/relearn	BLK_ABILITY_RELEARN	DCMD_BLK_FORCE_RELEARN, DCMD_FSYS_FORCE_RELEARN
  vfs/stats-clear	BLK_ABILITY_STATSCLEAR	DCMD_FSYS_STATISTICS, DCMD_FSYS_STATISTICS_CLR

  For more information, see Devctl and Ioctl Commands and the Utilities Reference.

Returns:

A numeric ability identifier, or a negative errno value if an error occurred. You can use the ability identifier in calls to procmgr_ability() or to verify the abilities of a client.

Classification:

QNX Neutrino