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"
52 COL_BPF_PROG_TYPE_RAW
,
70 COL_INOTIFY_INODES_RAW
,
114 COL_TIMERFD_INTERVAL
,
115 COL_TIMERFD_REMAINING
,
126 COL_UID
, /* process */
128 COL_USER
, /* process */
130 LSFD_N_COLS
/* This must be at last. */
150 ASSOC_MEM
, /* private file mapping */
151 ASSOC_SHM
, /* shared file mapping */
157 struct proc
* leader
;
161 struct list_head procs
;
162 struct list_head files
;
163 unsigned int kthread
: 1;
164 struct list_head eventpolls
;
167 struct proc
*get_proc(pid_t pid
);
173 struct list_head files
;
174 const struct file_class
*class;
185 unsigned int sys_flags
;
189 uint8_t read
:1, write
:1;
194 #define is_opened_file(_f) ((_f)->association >= 0)
195 #define is_mapped_file(_f) (is_association((_f), SHM) || is_association((_f), MEM))
196 #define is_association(_f, a) ((_f)->association < 0 && (_f)->association == -ASSOC_ ## a)
199 const struct file_class
*super
;
201 void (*initialize_class
)(void);
202 void (*finalize_class
)(void);
203 bool (*fill_column
)(struct proc
*proc
,
205 struct libscols_line
*ln
,
207 size_t column_index
);
208 int (*handle_fdinfo
)(struct file
*file
, const char *key
, const char* value
);
209 void (*attach_xinfo
)(struct file
*file
);
210 void (*initialize_content
)(struct file
*file
);
211 void (*free_content
)(struct file
*file
);
212 const struct ipc_class
*(*get_ipc_class
)(struct file
*file
);
215 extern const struct file_class file_class
, cdev_class
, bdev_class
, sock_class
, unkn_class
, fifo_class
,
216 nsfs_file_class
, mqueue_file_class
;
222 const struct ipc_class
*class;
223 struct list_head endpoints
;
224 struct list_head ipcs
;
227 struct ipc_endpoint
{
229 struct list_head endpoints
;
234 unsigned int (*get_hash
)(struct file
*file
);
235 bool (*is_suitable_ipc
)(struct ipc
*ipc
, struct file
*file
);
236 void (*free
)(struct ipc
*ipc
);
239 struct ipc
*new_ipc(const struct ipc_class
*class);
240 struct ipc
*get_ipc(struct file
*file
);
241 void add_ipc(struct ipc
*ipc
, unsigned int hash
);
242 void init_endpoint(struct ipc_endpoint
*endpoint
);
243 void add_endpoint(struct ipc_endpoint
*endpoint
, struct ipc
*ipc
);
244 #define foreach_endpoint(E,ENDPOINT) list_for_each_backwardly(E, &((ENDPOINT).ipc->endpoints))
246 enum decode_source_bit
{
247 DECODE_SOURCE_MAJMIN_BIT
= 1 << 0,
248 DECODE_SOURCE_PARTITION_BIT
= 1 << 1,
249 DECODE_SOURCE_FILESYS_BIT
= 1 << 2,
252 enum decode_source_level
{
253 DECODE_SOURCE_MAJMIN
= DECODE_SOURCE_MAJMIN_BIT
,
254 DECODE_SOURCE_PARTITION
= DECODE_SOURCE_PARTITION_BIT
| DECODE_SOURCE_MAJMIN
,
255 DECODE_SOURCE_FILESYS
= DECODE_SOURCE_FILESYS_BIT
| DECODE_SOURCE_PARTITION
,
256 DECODE_SOURCE_FULL
= DECODE_SOURCE_FILESYS
,
259 void decode_source(char *buf
, size_t bufsize
, unsigned int dev_major
, unsigned int dev_minor
,
260 enum decode_source_level level
);
266 struct name_manager
*new_name_manager(void);
267 void free_name_manager(struct name_manager
*nm
);
268 const char *get_name(struct name_manager
*nm
, unsigned long id
);
269 unsigned long add_name(struct name_manager
*nm
, const char *name
);
271 const char *get_partition(dev_t dev
);
272 const char *get_blkdrv(unsigned long major
);
273 const char *get_chrdrv(unsigned long major
);
274 const char *get_miscdev(unsigned long minor
);
275 const char *get_nodev_filesystem(unsigned long minor
);
276 void add_nodev(unsigned long minor
, const char *filesystem
);
281 void load_sock_xinfo(struct path_cxt
*pc
, const char *name
, ino_t netns
);
282 bool is_nsfs_dev(dev_t dev
);
287 /* 0 is assumed as the major dev for DEV. */
288 bool is_mqueue_dev(dev_t dev
);
293 bool is_multiplexed_by_eventpoll(int fd
, struct list_head
*eventpolls
);
295 #endif /* UTIL_LINUX_LSFD_H */