2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2003 Mike Barcroft <mike@FreeBSD.org>
5 * Copyright (c) 2008 Bjoern A. Zeeb <bz@FreeBSD.org>
6 * Copyright (c) 2009 James Gritton <jamie@FreeBSD.org>
7 * Copyright (c) 2015 Emmanuel Vadot <manu@bocal.org>
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 #include <sys/cdefs.h>
33 __FBSDID("$FreeBSD$");
35 #include <sys/param.h>
37 #include <sys/socket.h>
38 #include <sys/sysctl.h>
40 #include <arpa/inet.h>
41 #include <netinet/in.h>
53 #define JP_USER 0x01000000
54 #define JP_OPT 0x02000000
56 #define JLS_XO_VERSION "1"
58 #define PRINT_DEFAULT 0x01
59 #define PRINT_HEADER 0x02
60 #define PRINT_NAMEVAL 0x04
61 #define PRINT_QUOTED 0x08
62 #define PRINT_SKIP 0x10
63 #define PRINT_VERBOSE 0x20
64 #define PRINT_JAIL_NAME 0x40
66 static struct jailparam *params;
67 static int *param_parent;
76 static int add_param(const char *name, void *value, size_t valuelen,
77 struct jailparam *source, unsigned flags);
78 static int sort_param(const void *a, const void *b);
79 static char *noname(const char *name);
80 static char *nononame(const char *name);
81 static int print_jail(int pflags, int jflags);
82 static void quoted_print(int pflags, char *name, char *value);
85 main(int argc, char **argv)
87 char *dot, *ep, *jname, *pname;
88 int c, i, jflags, jid, lastjid, pflags, spc;
90 argc = xo_parse_args(argc, argv);
94 xo_set_version(JLS_XO_VERSION);
96 pflags = jflags = jid = 0;
97 while ((c = getopt(argc, argv, "adj:hNnqsv")) >= 0)
101 jflags |= JAIL_DYING;
104 jid = strtoul(optarg, &ep, 10);
111 pflags = (pflags & ~(PRINT_SKIP | PRINT_VERBOSE)) |
115 pflags |= PRINT_JAIL_NAME;
118 pflags = (pflags & ~PRINT_VERBOSE) | PRINT_NAMEVAL;
121 pflags |= PRINT_QUOTED;
124 pflags = (pflags & ~(PRINT_HEADER | PRINT_VERBOSE)) |
125 PRINT_NAMEVAL | PRINT_QUOTED | PRINT_SKIP;
129 ~(PRINT_HEADER | PRINT_NAMEVAL | PRINT_SKIP)) |
133 xo_errx(1, "usage: jls [-dhNnqv] [-j jail] [param ...]");
137 ip6_ok = feature_present("inet6");
140 ip4_ok = feature_present("inet");
143 /* Add the parameters to print. */
144 if (optind == argc) {
145 if (pflags & (PRINT_HEADER | PRINT_NAMEVAL))
146 add_param("all", NULL, (size_t)0, NULL, JP_USER);
147 else if (pflags & PRINT_VERBOSE) {
148 add_param("jid", NULL, (size_t)0, NULL, JP_USER);
149 add_param("host.hostname", NULL, (size_t)0, NULL,
151 add_param("path", NULL, (size_t)0, NULL, JP_USER);
152 add_param("name", NULL, (size_t)0, NULL, JP_USER);
153 add_param("dying", NULL, (size_t)0, NULL, JP_USER);
154 add_param("cpuset.id", NULL, (size_t)0, NULL, JP_USER);
157 add_param("ip4.addr", NULL, (size_t)0, NULL,
162 add_param("ip6.addr", NULL, (size_t)0, NULL,
166 pflags |= PRINT_DEFAULT;
167 if (pflags & PRINT_JAIL_NAME)
168 add_param("name", NULL, (size_t)0, NULL, JP_USER);
170 add_param("jid", NULL, (size_t)0, NULL, JP_USER);
173 add_param("ip4.addr", NULL, (size_t)0, NULL,
176 add_param("host.hostname", NULL, (size_t)0, NULL,
178 add_param("path", NULL, (size_t)0, NULL, JP_USER);
181 pflags &= ~PRINT_VERBOSE;
182 while (optind < argc)
183 add_param(argv[optind++], NULL, (size_t)0, NULL,
187 if (pflags & PRINT_SKIP) {
188 /* Check for parameters with jailsys parents. */
189 for (i = 0; i < nparams; i++) {
190 if ((params[i].jp_flags & JP_USER) &&
191 (dot = strchr(params[i].jp_name, '.'))) {
192 pname = alloca((dot - params[i].jp_name) + 1);
193 strlcpy(pname, params[i].jp_name,
194 (dot - params[i].jp_name) + 1);
195 param_parent[i] = add_param(pname,
196 NULL, (size_t)0, NULL, JP_OPT);
201 /* Add the index key parameters. */
203 add_param("jid", &jid, sizeof(jid), NULL, 0);
204 else if (jname != NULL)
205 add_param("name", jname, strlen(jname), NULL, 0);
207 add_param("lastjid", &lastjid, sizeof(lastjid), NULL, 0);
209 /* Print a header line if requested. */
210 if (pflags & PRINT_VERBOSE) {
211 xo_emit("{T:/%3s}{T:JID}{P: }{T:Hostname}{Pd:/%22s}{T:Path}\n",
213 xo_emit("{P:/%8s}{T:Name}{Pd:/%26s}{T:State}\n", "", "");
214 xo_emit("{P:/%8s}{T:CPUSetID}\n", "");
215 xo_emit("{P:/%8s}{T:IP Address(es)}\n", "");
217 else if (pflags & PRINT_DEFAULT)
218 if (pflags & PRINT_JAIL_NAME)
219 xo_emit("{P: }{T:JID/%-15s}{P: }{T:IP Address/%-15s}"
220 "{P: }{T:Hostname/%-29s}{P: }{T:Path}\n");
222 xo_emit("{T:JID/%6s}{P: }{T:IP Address}{P:/%6s}"
223 "{T:Hostname}{P:/%22s}{T:Path}\n", "", "");
224 else if (pflags & PRINT_HEADER) {
225 for (i = spc = 0; i < nparams; i++)
226 if (params[i].jp_flags & JP_USER) {
231 xo_emit(params[i].jp_name);
236 xo_open_container("jail-information");
237 xo_open_list("jail");
238 /* Fetch the jail(s) and print the parameters. */
239 if (jid != 0 || jname != NULL) {
240 if (print_jail(pflags, jflags) < 0)
241 xo_errx(1, "%s", jail_errmsg);
244 (lastjid = print_jail(pflags, jflags)) >= 0; )
246 if (errno != 0 && errno != ENOENT)
247 xo_errx(1, "%s", jail_errmsg);
249 xo_close_list("jail");
250 xo_close_container("jail-information");
256 add_param(const char *name, void *value, size_t valuelen,
257 struct jailparam *source, unsigned flags)
259 struct jailparam *param, *tparams;
262 static int paramlistsize;
264 /* The pseudo-parameter "all" scans the list of available parameters. */
265 if (!strcmp(name, "all")) {
266 tnparams = jailparam_all(&tparams);
268 xo_errx(1, "%s", jail_errmsg);
269 qsort(tparams, (size_t)tnparams, sizeof(struct jailparam),
271 for (i = 0; i < tnparams; i++)
272 add_param(tparams[i].jp_name, NULL, (size_t)0,
278 /* Check for repeat parameters. */
279 for (i = 0; i < nparams; i++)
280 if (!strcmp(name, params[i].jp_name)) {
281 if (value != NULL && jailparam_import_raw(params + i,
282 value, valuelen) < 0)
283 xo_errx(1, "%s", jail_errmsg);
284 params[i].jp_flags |= flags;
286 jailparam_free(source, 1);
290 /* Make sure there is room for the new param record. */
293 params = malloc(paramlistsize * sizeof(*params));
294 param_parent = malloc(paramlistsize * sizeof(*param_parent));
295 if (params == NULL || param_parent == NULL)
297 } else if (nparams >= paramlistsize) {
299 params = realloc(params, paramlistsize * sizeof(*params));
300 param_parent = realloc(param_parent,
301 paramlistsize * sizeof(*param_parent));
302 if (params == NULL || param_parent == NULL)
303 xo_err(1, "realloc");
306 /* Look up the parameter. */
307 param_parent[nparams] = -1;
308 param = params + nparams++;
309 if (source != NULL) {
311 param->jp_flags |= flags;
312 return param - params;
314 if (jailparam_init(param, name) < 0 ||
315 (value != NULL ? jailparam_import_raw(param, value, valuelen)
316 : jailparam_import(param, value)) < 0) {
317 if (flags & JP_OPT) {
321 xo_errx(1, "%s", jail_errmsg);
323 param->jp_flags = flags;
324 return param - params;
328 sort_param(const void *a, const void *b)
330 const struct jailparam *parama, *paramb;
333 /* Put top-level parameters first. */
336 ap = strchr(parama->jp_name, '.');
337 bp = strchr(paramb->jp_name, '.');
342 return (strcmp(parama->jp_name, paramb->jp_name));
346 noname(const char *name)
350 nname = malloc(strlen(name) + 3);
353 p = strrchr(name, '.');
355 sprintf(nname, "%.*s.no%s", (int)(p - name), name, p + 1);
357 sprintf(nname, "no%s", name);
362 nononame(const char *name)
366 p = strrchr(name, '.');
367 if (strncmp(p ? p + 1 : name, "no", 2))
369 nname = malloc(strlen(name) - 1);
373 sprintf(nname, "%.*s.%s", (int)(p - name), name, p + 3);
375 strcpy(nname, name + 2);
380 print_jail(int pflags, int jflags)
382 char *nname, *xo_nname;
384 int i, ai, jid, count, n, spc;
385 char ipbuf[INET6_ADDRSTRLEN];
387 jid = jailparam_get(params, nparams, jflags);
391 xo_open_instance("jail");
393 if (pflags & PRINT_VERBOSE) {
394 xo_emit("{:jid/%6d}{P: }{:hostname/%-29.29s/%s}{P: }"
395 "{:path/%.74s/%s}\n",
396 *(int *)params[0].jp_value,
397 (char *)params[1].jp_value,
398 (char *)params[2].jp_value);
399 xo_emit("{P: }{:name/%-29.29s/%s}{P: }{:state/%.74s}\n",
400 (char *)params[3].jp_value,
401 *(int *)params[4].jp_value ? "DYING" : "ACTIVE");
402 xo_emit("{P: }{:cpusetid/%d}\n", *(int *)params[5].jp_value);
405 if (ip4_ok && !strcmp(params[n].jp_name, "ip4.addr")) {
406 count = params[n].jp_valuelen / sizeof(struct in_addr);
407 for (ai = 0; ai < count; ai++)
408 if (inet_ntop(AF_INET,
409 &((struct in_addr *)params[n].jp_value)[ai],
410 ipbuf, sizeof(ipbuf)) == NULL)
411 xo_err(1, "inet_ntop");
413 xo_emit("{P: }{l:ipv4_addrs}{P:\n}", ipbuf);
419 if (ip6_ok && !strcmp(params[n].jp_name, "ip6.addr")) {
420 count = params[n].jp_valuelen / sizeof(struct in6_addr);
421 for (ai = 0; ai < count; ai++)
422 if (inet_ntop(AF_INET6,
423 &((struct in6_addr *)
424 params[n].jp_value)[ai],
425 ipbuf, sizeof(ipbuf)) == NULL)
426 xo_err(1, "inet_ntop");
428 xo_emit("{P: }{l:ipv6_addrs}{P:\n}", ipbuf);
432 } else if (pflags & PRINT_DEFAULT) {
433 if (pflags & PRINT_JAIL_NAME)
434 xo_emit("{P: }{:name/%-15s/%s}{P: }",
435 (char *)params[0].jp_value);
437 xo_emit("{:jid/%6d}{P: }", *(int *)params[0].jp_value);
438 xo_emit("{:ipv4/%-15.15s/%s}{P: }{:hostname/%-29.29s/%s}{P: }{:path/%.74s/%s}\n",
440 (!ip4_ok || params[1].jp_valuelen == 0) ? ""
441 : inet_ntoa(*(struct in_addr *)params[1].jp_value),
442 (char *)params[2-!ip4_ok].jp_value,
443 (char *)params[3-!ip4_ok].jp_value);
446 (char *)params[1].jp_value,
447 (char *)params[2].jp_value);
450 param_values = alloca(nparams * sizeof(*param_values));
451 for (i = 0; i < nparams; i++) {
452 if (!(params[i].jp_flags & JP_USER))
454 param_values[i] = jailparam_export(params + i);
455 if (param_values[i] == NULL)
456 xo_errx(1, "%s", jail_errmsg);
458 for (i = spc = 0; i < nparams; i++) {
459 if (!(params[i].jp_flags & JP_USER))
461 if ((pflags & PRINT_SKIP) &&
462 ((!(params[i].jp_ctltype &
463 (CTLFLAG_WR | CTLFLAG_TUN))) ||
464 (param_parent[i] >= 0 &&
465 *(int *)params[param_parent[i]].jp_value !=
472 if (pflags & PRINT_NAMEVAL) {
474 * Generally "name=value", but for booleans
475 * either "name" or "noname".
477 if (params[i].jp_flags &
478 (JP_BOOL | JP_NOBOOL)) {
479 if (*(int *)params[i].jp_value) {
480 asprintf(&xo_nname, "{en:%s/true}", params[i].jp_name);
482 xo_emit("{d:/%s}", params[i].jp_name);
485 nname = (params[i].jp_flags &
487 nononame(params[i].jp_name)
488 : noname(params[i].jp_name);
489 if (params[i].jp_flags & JP_NOBOOL) {
490 asprintf(&xo_nname, "{en:%s/true}", params[i].jp_name);
493 asprintf(&xo_nname, "{en:%s/false}", params[i].jp_name);
496 xo_emit("{d:/%s}", nname);
502 xo_emit("{d:%s}=", params[i].jp_name);
504 if (params[i].jp_valuelen == 0) {
505 if (pflags & PRINT_QUOTED)
507 else if (!(pflags & PRINT_NAMEVAL))
510 quoted_print(pflags, params[i].jp_name, param_values[i]);
514 for (i = 0; i < nparams; i++)
515 if (params[i].jp_flags & JP_USER)
516 free(param_values[i]);
519 xo_close_instance("jail");
524 quoted_print(int pflags, char *name, char *value)
528 char *param_name_value;
530 /* An empty string needs quoting. */
532 asprintf(¶m_name_value, "{k:%s}{d:%s/\"\"}", name, name);
533 xo_emit(param_name_value);
534 free(param_name_value);
538 asprintf(¶m_name_value, "{:%s/%%s}", name);
540 * The value will be surrounded by quotes if it contains spaces
543 qc = strchr(p, '\'') ? '"'
544 : strchr(p, '"') ? '\''
545 : strchr(p, ' ') || strchr(p, '\t') ? '"'
548 if (qc && pflags & PRINT_QUOTED)
549 xo_emit("{P:/%c}", qc);
551 xo_emit(param_name_value, value);
553 free(param_name_value);
555 if (qc && pflags & PRINT_QUOTED)
556 xo_emit("{P:/%c}", qc);