DCMD_F3S_* Parent topic: DCMD_F3S_*

DCMD_F3S_RECLAIMCTL

Updated: October 28, 2024

Provide runtime control of reclaims

Synopsis:

#include <sys/dcmd_f3s.h>

#define DCMD_F3S_RECLAIMCTL __DIOTF(_DCMD_F3S, F3S_RECLAIMCTL, f3s_reclaimctl_t)

Arguments to devctl():

Argument Value
filedes A file descriptor that you obtained by opening the device.
dcmd DCMD_F3S_RECLAIMCTL
dev_data_ptr A pointer to a f3s_reclaimctl_t structure (see below)
n_bytes sizeof(f3s_reclaimctl_t)
dev_info_ptr NULL

Description:

This command provides runtime control of reclaim operations.

Input:

A f3s_reclaimctl_t structure: 

typedef struct f3s_reclaimctl_s
{
  int16_t super_count;
  int16_t stale_percent;
  int16_t reclaim_enable;
  int16_t reserved;        /* To pad the structure */
}f3s_reclaimctl_t;

The members include:

super_count
The number of overwrite hops. If the value isn't -1, it becomes the new effective reclaim threshold.
stale_percent
The percentage of stale blocks. If the value isn't -1, it becomes the new effective reclaim trigger.
reclaim_enable
1 to enable reclaims, 0 to disable them, or -1 to leave the current setting unchanged.

Output:

A f3s_reclaimctl_t structure that's filled in by the driver with the old settings.

See also:

devctl() in the QNX Neutrino C Library Reference

Parent topic: DCMD_F3S_*