From a201343073c0bb4b4e33d5d3d101682d279aafce Mon Sep 17 00:00:00 2001
From: Benjamin Kaduk <bjk@FreeBSD.org>
Date: Thu, 4 Jun 2020 04:29:43 +0000
Subject: [PATCH] Add EXAMPLES to killall(1)

Submitted by:	fernape
Differential Revision:	https://reviews.freebsd.org/D25002
---
 usr.bin/killall/killall.1 | 44 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/usr.bin/killall/killall.1 b/usr.bin/killall/killall.1
index be813f78c46e..c369bbce22f2 100644
--- a/usr.bin/killall/killall.1
+++ b/usr.bin/killall/killall.1
@@ -145,6 +145,50 @@ utility exits 0 if some processes have been found and
 signalled successfully.
 Otherwise, a status of 1 will be
 returned.
+.Sh EXAMPLES
+Send
+.Dv SIGTERM
+to all firefox processes:
+.Bd -literal -offset indent
+killall firefox
+.Ed
+.Pp
+Send
+.Dv SIGTERM
+to firefox processes belonging to
+.Va USER :
+.Bd -literal -offset indent
+killall -u ${USER} firefox
+.Ed
+.Pp
+Stop all firefox processes:
+.Bd -literal -offset indent
+killall -SIGSTOP firefox
+.Ed
+.Pp
+Resume firefox processes:
+.Bd -literal -offset indent
+killall -SIGCONT firefox
+.Ed
+.Pp
+Show what would be done to firefox processes, but do not actually signal them:
+.Bd -literal -offset indent
+killall -s firefox
+.Ed
+.Pp
+Send
+.Dv SIGKILL
+to csh process running inside jail ID 282:
+.Bd -literal -offset indent
+killall -9 -j282 csh
+.Ed
+.Pp
+Send
+.Dv SIGTERM
+to all processes matching provided pattern (like vim and vimdiff):
+.Bd -literal -offset indent
+killall -m 'vim*'
+.Ed
 .Sh DIAGNOSTICS
 Diagnostic messages will only be printed if requested by
 .Fl d