X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=src%2Fcommon%2Ffd-tracker%2Ffd-tracker.h;h=ec859c085b67fbd4b6edeacd0631129e27734bf9;hb=f895927f329180ca1e6f4426e9d3c6250ae698ba;hp=b8082c9a7697f51eb9b2c7d30e3ef94610f6d450;hpb=9d16fc7fa401926b800c18124756d75b11b5b806;p=lttng-tools.git diff --git a/src/common/fd-tracker/fd-tracker.h b/src/common/fd-tracker/fd-tracker.h index b8082c9a7..ec859c085 100644 --- a/src/common/fd-tracker/fd-tracker.h +++ b/src/common/fd-tracker/fd-tracker.h @@ -1,23 +1,15 @@ /* - * Copyright (C) 2018 - Jérémie Galarneau + * Copyright (C) 2018 Jérémie Galarneau * - * This program is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License, version 2 only, as - * published by the Free Software Foundation. + * SPDX-License-Identifier: GPL-2.0-only * - * This program is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for - * more details. - * - * You should have received a copy of the GNU General Public License along with - * this program; if not, write to the Free Software Foundation, Inc., 51 - * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #ifndef FD_TRACKER_H #define FD_TRACKER_H +#include +#include #include #include @@ -52,8 +44,13 @@ typedef int (*fd_close_cb)(void *, int *in_fds); * Set the maximal number of fds that the process should be allowed to open at * any given time. This function must be called before any other of this * interface. + * + * The unlinked_file_path is an absolute path (which does not need to exist) + * under which unlinked files will be stored for as long as a reference to them + * is held. */ -struct fd_tracker *fd_tracker_create(unsigned int capacity); +struct fd_tracker *fd_tracker_create(const char *unlinked_file_path, + unsigned int capacity); /* Returns an error if file descriptors are leaked. */ int fd_tracker_destroy(struct fd_tracker *tracker); @@ -81,7 +78,10 @@ int fd_tracker_destroy(struct fd_tracker *tracker); * open. */ struct fs_handle *fd_tracker_open_fs_handle(struct fd_tracker *tracker, - const char *path, int flags, mode_t *mode); + struct lttng_directory_handle *directory, + const char *path, + int flags, + mode_t *mode); /* * Open a tracked unsuspendable file descriptor. @@ -103,11 +103,14 @@ struct fs_handle *fd_tracker_open_fs_handle(struct fd_tracker *tracker, * negative tracker-specific codes may be returned: * - ENOMEM: allocation of a new entry failed, * - EMFILE: too many unsuspendable fds are opened and the tracker can't - * accomodate the request for a new unsuspendable entry. + * accommodates the request for a new unsuspendable entry. */ int fd_tracker_open_unsuspendable_fd(struct fd_tracker *tracker, - int *out_fds, const char **names, unsigned int fd_count, - fd_open_cb open, void *data); + int *out_fds, + const char **names, + unsigned int fd_count, + fd_open_cb open, + void *data); /* * Close a tracked unsuspendable file descriptor. @@ -125,7 +128,9 @@ int fd_tracker_open_unsuspendable_fd(struct fd_tracker *tracker, * allows the user to know which file descriptors are no longer being tracked. */ int fd_tracker_close_unsuspendable_fd(struct fd_tracker *tracker, - int *fds, unsigned int fd_count, fd_close_cb close, + int *fds, + unsigned int fd_count, + fd_close_cb close, void *data); /*