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"
51 COL_BPF_PROG_TYPE_RAW
,
69 COL_INOTIFY_INODES_RAW
,
111 COL_TIMERFD_INTERVAL
,
112 COL_TIMERFD_REMAINING
,
123 COL_UID
, /* process */
125 COL_USER
, /* process */
127 LSFD_N_COLS
/* This must be at last. */
147 ASSOC_MEM
, /* private file mapping */
148 ASSOC_SHM
, /* shared file mapping */
154 struct proc
* leader
;
158 struct list_head procs
;
159 struct list_head files
;
160 unsigned int kthread
: 1;
161 struct list_head eventpolls
;
164 struct proc
*get_proc(pid_t pid
);
170 struct list_head files
;
171 const struct file_class
*class;
182 unsigned int sys_flags
;
186 uint8_t read
:1, write
:1;
191 #define is_opened_file(_f) ((_f)->association >= 0)
192 #define is_mapped_file(_f) (is_association((_f), SHM) || is_association((_f), MEM))
193 #define is_association(_f, a) ((_f)->association < 0 && (_f)->association == -ASSOC_ ## a)
196 const struct file_class
*super
;
198 void (*initialize_class
)(void);
199 void (*finalize_class
)(void);
200 bool (*fill_column
)(struct proc
*proc
,
202 struct libscols_line
*ln
,
204 size_t column_index
);
205 int (*handle_fdinfo
)(struct file
*file
, const char *key
, const char* value
);
206 void (*attach_xinfo
)(struct file
*file
);
207 void (*initialize_content
)(struct file
*file
);
208 void (*free_content
)(struct file
*file
);
209 const struct ipc_class
*(*get_ipc_class
)(struct file
*file
);
212 extern const struct file_class file_class
, cdev_class
, bdev_class
, sock_class
, unkn_class
, fifo_class
,
213 nsfs_file_class
, mqueue_file_class
;
219 const struct ipc_class
*class;
220 struct list_head endpoints
;
221 struct list_head ipcs
;
224 struct ipc_endpoint
{
226 struct list_head endpoints
;
231 unsigned int (*get_hash
)(struct file
*file
);
232 bool (*is_suitable_ipc
)(struct ipc
*ipc
, struct file
*file
);
233 void (*free
)(struct ipc
*ipc
);
236 struct ipc
*new_ipc(const struct ipc_class
*class);
237 struct ipc
*get_ipc(struct file
*file
);
238 void add_ipc(struct ipc
*ipc
, unsigned int hash
);
239 void init_endpoint(struct ipc_endpoint
*endpoint
);
240 void add_endpoint(struct ipc_endpoint
*endpoint
, struct ipc
*ipc
);
241 #define foreach_endpoint(E,ENDPOINT) list_for_each_backwardly(E, &((ENDPOINT).ipc->endpoints))
243 enum decode_source_bit
{
244 DECODE_SOURCE_MAJMIN_BIT
= 1 << 0,
245 DECODE_SOURCE_PARTITION_BIT
= 1 << 1,
246 DECODE_SOURCE_FILESYS_BIT
= 1 << 2,
249 enum decode_source_level
{
250 DECODE_SOURCE_MAJMIN
= DECODE_SOURCE_MAJMIN_BIT
,
251 DECODE_SOURCE_PARTITION
= DECODE_SOURCE_PARTITION_BIT
| DECODE_SOURCE_MAJMIN
,
252 DECODE_SOURCE_FILESYS
= DECODE_SOURCE_FILESYS_BIT
| DECODE_SOURCE_PARTITION
,
253 DECODE_SOURCE_FULL
= DECODE_SOURCE_FILESYS
,
256 void decode_source(char *buf
, size_t bufsize
, unsigned int dev_major
, unsigned int dev_minor
,
257 enum decode_source_level level
);
263 struct name_manager
*new_name_manager(void);
264 void free_name_manager(struct name_manager
*nm
);
265 const char *get_name(struct name_manager
*nm
, unsigned long id
);
266 unsigned long add_name(struct name_manager
*nm
, const char *name
);
268 const char *get_partition(dev_t dev
);
269 const char *get_blkdrv(unsigned long major
);
270 const char *get_chrdrv(unsigned long major
);
271 const char *get_miscdev(unsigned long minor
);
272 const char *get_nodev_filesystem(unsigned long minor
);
273 void add_nodev(unsigned long minor
, const char *filesystem
);
275 static inline void xstrappend(char **a
, const char *b
)
277 if (strappend(a
, b
) < 0)
278 err(XALLOC_EXIT_CODE
, _("failed to allocate memory for string"));
281 static inline void xstrputc(char **a
, char c
)
283 char b
[] = {c
, '\0'};
290 void load_sock_xinfo(struct path_cxt
*pc
, const char *name
, ino_t netns
);
291 bool is_nsfs_dev(dev_t dev
);
296 /* 0 is assumed as the major dev for DEV. */
297 bool is_mqueue_dev(dev_t dev
);
302 bool is_multiplexed_by_eventpoll(int fd
, struct list_head
*eventpolls
);
304 #endif /* UTIL_LINUX_LSFD_H */