au_fcntl_cmd(3)

au_fcntl_cmd3

Convert between bsm and local fcntl(2) command values

Part of au_bsm_to_fcntl_cmd(3).

Usage

#include <bsm/libbsm.h>

int

au_bsm_to_fcntl_cmd(u_short bsm_fcntl_cmd, int *local_fcntl_cmdp);

u_short

au_fcntl_cmd_to_bsm(int local_fcntl_cmd);

Library

library “libbsm”

Overview

These interfaces may be used to convert between the local and BSM fcntl(2) command values. The au_bsm_to_fcntl_cmd() function accepts a BSM command value, bsm_fcntl_cmd, and converts it to a local command value passed to fcntl(2), that will be stored in the integer pointed to by local_fcntl_cmdp if successful. This call will fail if the BSM command value cannot be mapped into a local fcntl(2) command value which may occur if the command token was generated on another operating system.

The au_fcntl_cmd_to_bsm() function accepts a local fcntl(2) command value, and returns the BSM fcntl(2) command value for it. This call cannot fail, and instead returns a BSM command value indicating to a later decoder that the command value could not be encoded.

Return values

On success, au_bsm_to_fcntl_cmd() returns 0 and a converted command value; on failure, it returns -1 but does not set errno(2).

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 2 times.

  1. 8.0–9.1
  2. 9.2–10.2
  3. 10.3–16.0

History

au_bsm_to_domain() and au_domain_to_bsm() were introduced in OpenBSM 1.1.

Authors

These functions were implemented by Stacey Son under contract to Apple Inc.

The Basic Security Module (BSM) interface to audit records and audit event stream format were defined by Sun Microsystems.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.