2 * SPDX-License-Identifier: BSD-3-Clause
4 * Copyright (c) 2009 Stanislav Sedov <stas@FreeBSD.org>
5 * Copyright (c) 1988, 1993
6 * The Regents of the University of California. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the name of the University nor the names of its contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
20 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 #include <sys/cdefs.h>
34 __FBSDID("$FreeBSD$");
36 #include <sys/param.h>
39 #include <sys/socket.h>
40 #include <sys/socketvar.h>
41 #include <sys/sysctl.h>
42 #include <sys/queue.h>
45 #include <netinet/in.h>
47 #include <arpa/inet.h>
52 #include <libprocstat.h>
63 #include "functions.h"
65 static int fsflg, /* show files on same filesystem as file(s) argument */
66 pflg, /* show files open by a particular pid */
67 sflg, /* show socket details */
68 uflg; /* show files open by a particular (effective) user */
69 static int checkfile; /* restrict to particular files or filesystems */
70 static int nflg; /* (numerical) display f.s. and rdev as dev_t */
71 static int mflg; /* include memory-mapped files */
72 static int vflg; /* be verbose */
82 static char *memf, *nlistf;
84 static int getfname(const char *filename);
85 static void dofiles(struct procstat *procstat, struct kinfo_proc *p);
86 static void print_access_flags(int flags);
87 static void print_file_info(struct procstat *procstat,
88 struct filestat *fst, const char *uname, const char *cmd, int pid);
89 static void print_pipe_info(struct procstat *procstat,
90 struct filestat *fst);
91 static void print_pts_info(struct procstat *procstat,
92 struct filestat *fst);
93 static void print_sem_info(struct procstat *procstat,
94 struct filestat *fst);
95 static void print_shm_info(struct procstat *procstat,
96 struct filestat *fst);
97 static void print_socket_info(struct procstat *procstat,
98 struct filestat *fst);
99 static void print_vnode_info(struct procstat *procstat,
100 struct filestat *fst);
101 static void usage(void) __dead2;
104 do_fstat(int argc, char **argv)
106 struct kinfo_proc *p;
107 struct passwd *passwd;
108 struct procstat *procstat;
113 what = KERN_PROC_PROC;
114 nlistf = memf = NULL;
115 while ((ch = getopt(argc, argv, "fmnp:su:vN:M:")) != -1)
135 if (!isdigit(*optarg)) {
136 warnx("-p requires a process id");
139 what = KERN_PROC_PID;
148 if (!(passwd = getpwnam(optarg)))
149 errx(1, "%s: unknown uid", optarg);
150 what = KERN_PROC_UID;
151 arg = passwd->pw_uid;
161 if (*(argv += optind)) {
162 for (; *argv; ++argv) {
166 if (!checkfile) /* file(s) specified, but none accessible */
170 if (fsflg && !checkfile) {
171 /* -f with no files means use wd */
172 if (getfname(".") == 0)
178 procstat = procstat_open_kvm(nlistf, memf);
180 procstat = procstat_open_sysctl();
181 if (procstat == NULL)
182 errx(1, "procstat_open()");
183 p = procstat_getprocs(procstat, what, arg, &cnt);
185 errx(1, "procstat_getprocs()");
192 "USER CMD PID FD DEV INUM MODE SZ|DV R/W");
195 "USER CMD PID FD MOUNT INUM MODE SZ|DV R/W");
196 if (checkfile && fsflg == 0)
202 * Go through the process list.
204 for (i = 0; i < cnt; i++) {
205 if (p[i].ki_stat == SZOMB)
207 dofiles(procstat, &p[i]);
209 procstat_freeprocs(procstat, p);
210 procstat_close(procstat);
215 dofiles(struct procstat *procstat, struct kinfo_proc *kp)
219 struct filestat *fst;
220 struct filestat_list *head;
223 uname = user_from_uid(kp->ki_uid, 0);
227 head = procstat_getfiles(procstat, kp, mflg);
230 STAILQ_FOREACH(fst, head, next)
231 print_file_info(procstat, fst, uname, cmd, pid);
232 procstat_freefiles(procstat, head);
237 print_file_info(struct procstat *procstat, struct filestat *fst,
238 const char *uname, const char *cmd, int pid)
242 const char *filename;
243 int error, fsmatch = 0;
244 char errbuf[_POSIX2_LINE_MAX];
247 if (checkfile != 0) {
248 if (fst->fs_type != PS_FST_TYPE_VNODE &&
249 fst->fs_type != PS_FST_TYPE_FIFO)
251 error = procstat_get_vnode_info(procstat, fst, &vn, errbuf);
255 for (d = devs; d != NULL; d = d->next)
256 if (d->fsid == vn.vn_fsid) {
258 if (d->ino == vn.vn_fileid) {
263 if (fsmatch == 0 || (filename == NULL && fsflg == 0))
268 * Print entry prefix.
270 printf("%-8.8s %-10s %5d", uname, cmd, pid);
271 if (fst->fs_uflags & PS_FST_UFLAG_TEXT)
273 else if (fst->fs_uflags & PS_FST_UFLAG_CDIR)
275 else if (fst->fs_uflags & PS_FST_UFLAG_RDIR)
277 else if (fst->fs_uflags & PS_FST_UFLAG_TRACE)
279 else if (fst->fs_uflags & PS_FST_UFLAG_MMAP)
281 else if (fst->fs_uflags & PS_FST_UFLAG_JAIL)
283 else if (fst->fs_uflags & PS_FST_UFLAG_CTTY)
286 printf(" %4d", fst->fs_fd);
289 * Print type-specific data.
291 switch (fst->fs_type) {
292 case PS_FST_TYPE_FIFO:
293 case PS_FST_TYPE_VNODE:
294 print_vnode_info(procstat, fst);
296 case PS_FST_TYPE_SOCKET:
297 print_socket_info(procstat, fst);
299 case PS_FST_TYPE_PIPE:
300 print_pipe_info(procstat, fst);
302 case PS_FST_TYPE_PTS:
303 print_pts_info(procstat, fst);
305 case PS_FST_TYPE_SHM:
306 print_shm_info(procstat, fst);
308 case PS_FST_TYPE_SEM:
309 print_sem_info(procstat, fst);
311 case PS_FST_TYPE_DEV:
316 "unknown file type %d for file %d of pid %d\n",
317 fst->fs_type, fst->fs_fd, pid);
319 if (filename && !fsflg)
320 printf(" %s", filename);
325 addr_to_string(struct sockaddr_storage *ss, char *buffer, int buflen)
327 char buffer2[INET6_ADDRSTRLEN];
328 struct sockaddr_in6 *sin6;
329 struct sockaddr_in *sin;
330 struct sockaddr_un *sun;
332 switch (ss->ss_family) {
334 sun = (struct sockaddr_un *)ss;
335 if (strlen(sun->sun_path) == 0)
336 strlcpy(buffer, "-", buflen);
338 strlcpy(buffer, sun->sun_path, buflen);
342 sin = (struct sockaddr_in *)ss;
343 if (sin->sin_addr.s_addr == INADDR_ANY)
344 snprintf(buffer, buflen, "%s:%d", "*",
345 ntohs(sin->sin_port));
346 else if (inet_ntop(AF_INET, &sin->sin_addr, buffer2,
347 sizeof(buffer2)) != NULL)
348 snprintf(buffer, buflen, "%s:%d", buffer2,
349 ntohs(sin->sin_port));
353 sin6 = (struct sockaddr_in6 *)ss;
354 if (IN6_IS_ADDR_UNSPECIFIED(&sin6->sin6_addr))
355 snprintf(buffer, buflen, "%s.%d", "*",
356 ntohs(sin6->sin6_port));
357 else if (inet_ntop(AF_INET6, &sin6->sin6_addr, buffer2,
358 sizeof(buffer2)) != NULL)
359 snprintf(buffer, buflen, "%s.%d", buffer2,
360 ntohs(sin6->sin6_port));
362 strlcpy(buffer, "-", buflen);
366 strlcpy(buffer, "", buflen);
374 print_socket_info(struct procstat *procstat, struct filestat *fst)
376 static const char *stypename[] = {
385 struct sockstat sock;
387 char errbuf[_POSIX2_LINE_MAX];
388 char src_addr[PATH_MAX], dst_addr[PATH_MAX];
389 struct sockaddr_un *sun;
393 error = procstat_get_socket_info(procstat, fst, &sock, errbuf);
398 if (sock.type > STYPEMAX)
399 printf("* %s ?%d", sock.dname, sock.type);
401 printf("* %s %s", sock.dname, stypename[sock.type]);
404 * protocol specific formatting
406 * Try to find interesting things to print. For tcp, the interesting
407 * thing is the address of the tcpcb, for udp and others, just the
408 * inpcb (socket pcb). For unix domain, its the address of the socket
409 * pcb and the address of the connected pcb (if connected). Otherwise
410 * just print the protocol number and address of the socket itself.
411 * The idea is not to duplicate netstat, but to make available enough
412 * information for further analysis.
414 switch (sock.dom_family) {
418 setprotoent(++isopen);
419 if ((pe = getprotobynumber(sock.proto)) != NULL)
420 printf(" %s", pe->p_name);
422 printf(" %d", sock.proto);
423 if (sock.proto == IPPROTO_TCP ) {
424 if (sock.inp_ppcb != 0)
425 printf(" %lx", (u_long)sock.inp_ppcb);
427 else if (sock.so_pcb != 0)
428 printf(" %lx", (u_long)sock.so_pcb);
432 addr_to_string(&sock.sa_local, src_addr, sizeof(src_addr)),
433 addr_to_string(&sock.sa_peer, dst_addr, sizeof(dst_addr)));
436 /* print address of pcb and connected pcb */
437 if (sock.so_pcb != 0) {
438 printf(" %lx", (u_long)sock.so_pcb);
440 char shoconn[4], *cp;
443 if (!(sock.so_rcv_sb_state & SBS_CANTRCVMORE))
446 if (!(sock.so_snd_sb_state & SBS_CANTSENDMORE))
449 printf(" %s %lx", shoconn,
450 (u_long)sock.unp_conn);
455 sun = (struct sockaddr_un *)&sock.sa_local;
457 * While generally we like to print two addresses,
458 * local and peer, for sockets, it turns out to be
459 * more useful to print the first non-null address for
460 * local sockets, as typically they aren't bound and
461 * connected, and the path strings can get long.
463 if (sun->sun_path[0] != 0)
464 addr_to_string(&sock.sa_local,
465 src_addr, sizeof(src_addr));
467 addr_to_string(&sock.sa_peer,
468 src_addr, sizeof(src_addr));
469 printf(" %s", src_addr);
472 /* print protocol number and socket address */
473 printf(" %d %lx", sock.proto, (u_long)sock.so_addr);
478 print_pipe_info(struct procstat *procstat, struct filestat *fst)
481 char errbuf[_POSIX2_LINE_MAX];
484 error = procstat_get_pipe_info(procstat, fst, &ps, errbuf);
489 printf("* pipe %8lx <-> %8lx", (u_long)ps.addr, (u_long)ps.peer);
490 printf(" %6zd", ps.buffer_cnt);
491 print_access_flags(fst->fs_fflags);
495 print_pts_info(struct procstat *procstat, struct filestat *fst)
498 char errbuf[_POSIX2_LINE_MAX];
501 error = procstat_get_pts_info(procstat, fst, &pts, errbuf);
506 printf("* pseudo-terminal master ");
507 if (nflg || !*pts.devname) {
508 printf("%#10jx", (uintmax_t)pts.dev);
510 printf("%10s", pts.devname);
512 print_access_flags(fst->fs_fflags);
516 print_sem_info(struct procstat *procstat, struct filestat *fst)
519 char errbuf[_POSIX2_LINE_MAX];
523 error = procstat_get_sem_info(procstat, fst, &sem, errbuf);
530 (void)snprintf(mode, sizeof(mode), "%o", sem.mode);
532 printf(" %-15s", fst->fs_path != NULL ? fst->fs_path : "-");
533 strmode(sem.mode, mode);
535 printf(" %10s %6u", mode, sem.value);
536 print_access_flags(fst->fs_fflags);
540 print_shm_info(struct procstat *procstat, struct filestat *fst)
543 char errbuf[_POSIX2_LINE_MAX];
547 error = procstat_get_shm_info(procstat, fst, &shm, errbuf);
554 (void)snprintf(mode, sizeof(mode), "%o", shm.mode);
556 printf(" %-15s", fst->fs_path != NULL ? fst->fs_path : "-");
557 strmode(shm.mode, mode);
559 printf(" %10s %6ju", mode, shm.size);
560 print_access_flags(fst->fs_fflags);
564 print_vnode_info(struct procstat *procstat, struct filestat *fst)
567 char errbuf[_POSIX2_LINE_MAX];
573 error = procstat_get_vnode_info(procstat, fst, &vn, errbuf);
576 else if (vn.vn_type == PS_FST_VTYPE_VBAD)
578 else if (vn.vn_type == PS_FST_VTYPE_VNON)
580 if (badtype != NULL) {
581 printf(" - - %10s -", badtype);
586 printf(" %#5jx", (uintmax_t)vn.vn_fsid);
587 else if (vn.vn_mntdir != NULL)
588 (void)printf(" %-8s", vn.vn_mntdir);
594 (void)snprintf(mode, sizeof(mode), "%o", vn.vn_mode);
596 strmode(vn.vn_mode, mode);
598 (void)printf(" %6jd %10s", (intmax_t)vn.vn_fileid, mode);
600 if (vn.vn_type == PS_FST_VTYPE_VBLK || vn.vn_type == PS_FST_VTYPE_VCHR) {
601 if (nflg || !*vn.vn_devname)
602 printf(" %#6jx", (uintmax_t)vn.vn_dev);
604 printf(" %6s", vn.vn_devname);
607 printf(" %6ju", (uintmax_t)vn.vn_size);
608 print_access_flags(fst->fs_fflags);
612 print_access_flags(int flags)
617 if (flags & PS_FST_FFLAG_READ)
619 if (flags & PS_FST_FFLAG_WRITE)
625 getfname(const char *filename)
630 if (stat(filename, &statbuf)) {
631 warn("%s", filename);
634 if ((cur = malloc(sizeof(DEVS))) == NULL)
639 cur->ino = statbuf.st_ino;
640 cur->fsid = statbuf.st_dev;
641 cur->name = filename;
648 (void)fprintf(stderr,
649 "usage: fstat [-fmnv] [-M core] [-N system] [-p pid] [-u user] [file ...]\n");