2 * lsfd(1) - list file descriptors
4 * Copyright (C) 2021 Red Hat, Inc. All rights reserved.
5 * Written by Masatake YAMATO <yamato@redhat.com>
7 * Very generally based on lsof(8) by Victor A. Abell <abe@purdue.edu>
8 * It supports multiple OSes. lsfd specializes to Linux.
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it would be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software Foundation,
22 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #ifndef UTIL_LINUX_LSFD_H
25 #define UTIL_LINUX_LSFD_H
32 #include "libsmartcols.h"
48 COL_BPF_PROG_TYPE_RAW
,
66 COL_INOTIFY_INODES_RAW
,
108 COL_TIMERFD_INTERVAL
,
109 COL_TIMERFD_REMAINING
,
120 COL_UID
, /* process */
122 COL_USER
, /* process */
124 LSFD_N_COLS
/* This must be at last. */
144 ASSOC_MEM
, /* private file mapping */
145 ASSOC_SHM
, /* shared file mapping */
151 struct proc
* leader
;
155 struct list_head procs
;
156 struct list_head files
;
157 unsigned int kthread
: 1;
158 struct list_head eventpolls
;
161 struct proc
*get_proc(pid_t pid
);
167 struct list_head files
;
168 const struct file_class
*class;
179 unsigned int sys_flags
;
183 uint8_t read
:1, write
:1;
188 #define is_opened_file(_f) ((_f)->association >= 0)
189 #define is_mapped_file(_f) (is_association((_f), SHM) || is_association((_f), MEM))
190 #define is_association(_f, a) ((_f)->association < 0 && (_f)->association == -ASSOC_ ## a)
193 const struct file_class
*super
;
195 void (*initialize_class
)(void);
196 void (*finalize_class
)(void);
197 bool (*fill_column
)(struct proc
*proc
,
199 struct libscols_line
*ln
,
201 size_t column_index
);
202 int (*handle_fdinfo
)(struct file
*file
, const char *key
, const char* value
);
203 void (*attach_xinfo
)(struct file
*file
);
204 void (*initialize_content
)(struct file
*file
);
205 void (*free_content
)(struct file
*file
);
206 const struct ipc_class
*(*get_ipc_class
)(struct file
*file
);
209 extern const struct file_class file_class
, cdev_class
, bdev_class
, sock_class
, unkn_class
, fifo_class
,
210 nsfs_file_class
, mqueue_file_class
;
216 const struct ipc_class
*class;
217 struct list_head endpoints
;
218 struct list_head ipcs
;
221 struct ipc_endpoint
{
223 struct list_head endpoints
;
228 unsigned int (*get_hash
)(struct file
*file
);
229 bool (*is_suitable_ipc
)(struct ipc
*ipc
, struct file
*file
);
230 void (*free
)(struct ipc
*ipc
);
233 struct ipc
*new_ipc(const struct ipc_class
*class);
234 struct ipc
*get_ipc(struct file
*file
);
235 void add_ipc(struct ipc
*ipc
, unsigned int hash
);
236 void init_endpoint(struct ipc_endpoint
*endpoint
);
237 void add_endpoint(struct ipc_endpoint
*endpoint
, struct ipc
*ipc
);
238 #define foreach_endpoint(E,ENDPOINT) list_for_each_backwardly(E, &((ENDPOINT).ipc->endpoints))
240 enum decode_source_bit
{
241 DECODE_SOURCE_MAJMIN_BIT
= 1 << 0,
242 DECODE_SOURCE_PARTITION_BIT
= 1 << 1,
243 DECODE_SOURCE_FILESYS_BIT
= 1 << 2,
246 enum decode_source_level
{
247 DECODE_SOURCE_MAJMIN
= DECODE_SOURCE_MAJMIN_BIT
,
248 DECODE_SOURCE_PARTITION
= DECODE_SOURCE_PARTITION_BIT
| DECODE_SOURCE_MAJMIN
,
249 DECODE_SOURCE_FILESYS
= DECODE_SOURCE_FILESYS_BIT
| DECODE_SOURCE_PARTITION
,
250 DECODE_SOURCE_FULL
= DECODE_SOURCE_FILESYS
,
253 void decode_source(char *buf
, size_t bufsize
, unsigned int dev_major
, unsigned int dev_minor
,
254 enum decode_source_level level
);
260 struct name_manager
*new_name_manager(void);
261 void free_name_manager(struct name_manager
*nm
);
262 const char *get_name(struct name_manager
*nm
, unsigned long id
);
263 unsigned long add_name(struct name_manager
*nm
, const char *name
);
265 const char *get_partition(dev_t dev
);
266 const char *get_blkdrv(unsigned long major
);
267 const char *get_chrdrv(unsigned long major
);
268 const char *get_miscdev(unsigned long minor
);
269 const char *get_nodev_filesystem(unsigned long minor
);
270 void add_nodev(unsigned long minor
, const char *filesystem
);
272 static inline void xstrappend(char **a
, const char *b
)
274 if (strappend(a
, b
) < 0)
275 err(XALLOC_EXIT_CODE
, _("failed to allocate memory for string"));
278 static inline void xstrputc(char **a
, char c
)
280 char b
[] = {c
, '\0'};
287 void load_sock_xinfo(struct path_cxt
*pc
, const char *name
, ino_t netns
);
288 bool is_nsfs_dev(dev_t dev
);
293 /* 0 is assumed as the major dev for DEV. */
294 bool is_mqueue_dev(dev_t dev
);
299 bool is_multiplexed_by_eventpoll(int fd
, struct list_head
*eventpolls
);
301 #endif /* UTIL_LINUX_LSFD_H */