1 .TH llapi_changelog_clear 3 "2022-11-08" "" "Lustre User API"
3 llapi_changelog_clear \- Clear changelog records for a changelog consumer
6 .B #include <lustre/lustreapi.h>
8 .BI "int llapi_changelog_clear(const char *" mdtname ", const char *" idstr ",
9 .BI " long long " endrec ");"
14 .B llapi_changelog_clear()
15 indicates that changelog records previous to
17 are no longer of interest to a particular consumer
19 , potentially allowing the MDT
21 (e.g: "lustrefs-MDT0000") to free up disk space.
25 of 0 indicates the current last record.
27 Changelog consumers must be registered on the
30 .BI "lctl --device " MDT_NAME " changelog_register"
33 Return the file descriptor on success or a negative errno value on failure.
37 One or more invalid arguments are given.
40 MDT's changelog char device or changelog user not found.
43 Not enough permissions to open the changelog char device. By default, the device
44 is only accessible to the root user.
46 An example can be found for in lfs.c source file.
47 .B lfs_changelog_clear
48 implements the following command:
50 .BI "lfs changelog_clear " MDTNAME " " ID " " ENDREC ""
52 .BR lfs-changelog_clear (1),
53 .BR llapi_changelog_get_fd (3)
54 .BR llapi_changelog_in_buf (3),
55 .BR llapi_changelog_recv (3),
56 .BR llapi_changelog_start (3),
58 .BR lctl-changelog_register (8)