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
60 COL_INOTIFY_INODES_RAW
,
102 COL_TIMERFD_INTERVAL
,
103 COL_TIMERFD_REMAINING
,
114 COL_UID
, /* process */
116 COL_USER
, /* process */
118 LSFD_N_COLS
/* This must be at last. */
138 ASSOC_MEM
, /* private file mapping */
139 ASSOC_SHM
, /* shared file mapping */
145 struct proc
* leader
;
149 struct list_head procs
;
150 struct list_head files
;
151 unsigned int kthread
: 1;
152 struct list_head eventpolls
;
155 struct proc
*get_proc(pid_t pid
);
161 struct list_head files
;
162 const struct file_class
*class;
173 unsigned int sys_flags
;
177 uint8_t read
:1, write
:1;
182 #define is_opened_file(_f) ((_f)->association >= 0)
183 #define is_mapped_file(_f) (is_association((_f), SHM) || is_association((_f), MEM))
184 #define is_association(_f, a) ((_f)->association < 0 && (_f)->association == -ASSOC_ ## a)
187 const struct file_class
*super
;
189 void (*initialize_class
)(void);
190 void (*finalize_class
)(void);
191 bool (*fill_column
)(struct proc
*proc
,
193 struct libscols_line
*ln
,
195 size_t column_index
);
196 int (*handle_fdinfo
)(struct file
*file
, const char *key
, const char* value
);
197 void (*attach_xinfo
)(struct file
*file
);
198 void (*initialize_content
)(struct file
*file
);
199 void (*free_content
)(struct file
*file
);
200 const struct ipc_class
*(*get_ipc_class
)(struct file
*file
);
203 extern const struct file_class file_class
, cdev_class
, bdev_class
, sock_class
, unkn_class
, fifo_class
,
204 nsfs_file_class
, mqueue_file_class
;
210 const struct ipc_class
*class;
211 struct list_head endpoints
;
212 struct list_head ipcs
;
215 struct ipc_endpoint
{
217 struct list_head endpoints
;
222 unsigned int (*get_hash
)(struct file
*file
);
223 bool (*is_suitable_ipc
)(struct ipc
*ipc
, struct file
*file
);
224 void (*free
)(struct ipc
*ipc
);
227 struct ipc
*new_ipc(const struct ipc_class
*class);
228 struct ipc
*get_ipc(struct file
*file
);
229 void add_ipc(struct ipc
*ipc
, unsigned int hash
);
230 void init_endpoint(struct ipc_endpoint
*endpoint
);
231 void add_endpoint(struct ipc_endpoint
*endpoint
, struct ipc
*ipc
);
232 #define foreach_endpoint(E,ENDPOINT) list_for_each_backwardly(E, &((ENDPOINT).ipc->endpoints))
234 enum decode_source_bit
{
235 DECODE_SOURCE_MAJMIN_BIT
= 1 << 0,
236 DECODE_SOURCE_PARTITION_BIT
= 1 << 1,
237 DECODE_SOURCE_FILESYS_BIT
= 1 << 2,
240 enum decode_source_level
{
241 DECODE_SOURCE_MAJMIN
= DECODE_SOURCE_MAJMIN_BIT
,
242 DECODE_SOURCE_PARTITION
= DECODE_SOURCE_PARTITION_BIT
| DECODE_SOURCE_MAJMIN
,
243 DECODE_SOURCE_FILESYS
= DECODE_SOURCE_FILESYS_BIT
| DECODE_SOURCE_PARTITION
,
244 DECODE_SOURCE_FULL
= DECODE_SOURCE_FILESYS
,
247 void decode_source(char *buf
, size_t bufsize
, unsigned int dev_major
, unsigned int dev_minor
,
248 enum decode_source_level level
);
254 struct name_manager
*new_name_manager(void);
255 void free_name_manager(struct name_manager
*nm
);
256 const char *get_name(struct name_manager
*nm
, unsigned long id
);
257 unsigned long add_name(struct name_manager
*nm
, const char *name
);
259 const char *get_partition(dev_t dev
);
260 const char *get_blkdrv(unsigned long major
);
261 const char *get_chrdrv(unsigned long major
);
262 const char *get_miscdev(unsigned long minor
);
263 const char *get_nodev_filesystem(unsigned long minor
);
264 void add_nodev(unsigned long minor
, const char *filesystem
);
266 static inline void xstrappend(char **a
, const char *b
)
268 if (strappend(a
, b
) < 0)
269 err(XALLOC_EXIT_CODE
, _("failed to allocate memory for string"));
272 static inline void xstrputc(char **a
, char c
)
274 char b
[] = {c
, '\0'};
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 */