sensor_roll_set_path()

Updated: April 19, 2023

Set the sensor roll path

Synopsis:

#include <sensor/sensor_api.h>
sensor_error_t sensor_roll_set_path(sensor_handle_t handle,
                                    char *pathname)

Arguments:

handle
The handle that's returned from calling sensor_open().
pathname
The absolute path to the new sensor roll directory as a NULL-terminated string. Specifying an empty string will reset the sensor roll path to its default value.

Library:

libsensor

Description:

Use this function to change the directory that the Sensor library uses to generate filenames when you call sensor_roll_open_file(). The value you set for the pathname argument must a NULL-terminated string and must not be larger than SENSOR_MAX_FILENAME_LEN. The path you select must be a directory which your application has write access to.

Returns:

SENSOR_EOK when the function successfully completes, otherwise another sensor_error_t value that provides the reason that the call failed.