2 * SPDX-License-Identifier: BSD-2-Clause
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/param.h>
34 #include <sys/socket.h>
35 #include <sys/sysctl.h>
37 #include <arpa/inet.h>
38 #include <netinet/in.h>
50 #define JP_USER 0x01000000
51 #define JP_OPT 0x02000000
53 #define JLS_XO_VERSION "2"
55 #define PRINT_DEFAULT 0x01
56 #define PRINT_HEADER 0x02
57 #define PRINT_NAMEVAL 0x04
58 #define PRINT_QUOTED 0x08
59 #define PRINT_SKIP 0x10
60 #define PRINT_VERBOSE 0x20
61 #define PRINT_JAIL_NAME 0x40
63 static struct jailparam *params;
64 static int *param_parent;
73 static int add_param(const char *name, void *value, size_t valuelen,
74 struct jailparam *source, unsigned flags);
75 static int sort_param(const void *a, const void *b);
76 static char *noname(const char *name);
77 static char *nononame(const char *name);
78 static int print_jail(int pflags, int jflags);
79 static int special_print(int pflags, struct jailparam *param);
80 static void quoted_print(int pflags, char *name, char *value);
81 static void emit_ip_addr_list(int af_family, const char *list_name,
82 struct jailparam *param);
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;
385 #if (defined INET || defined INET6)
389 jid = jailparam_get(params, nparams, jflags);
393 xo_open_instance("jail");
395 if (pflags & PRINT_VERBOSE) {
396 xo_emit("{:jid/%6d}{P: }{:hostname/%-29.29s/%s}{P: }"
397 "{:path/%.74s/%s}\n",
398 *(int *)params[0].jp_value,
399 (char *)params[1].jp_value,
400 (char *)params[2].jp_value);
401 xo_emit("{P: }{:name/%-29.29s/%s}{P: }{:state/%.74s}\n",
402 (char *)params[3].jp_value,
403 *(int *)params[4].jp_value ? "DYING" : "ACTIVE");
404 xo_emit("{P: }{:cpusetid/%d}\n", *(int *)params[5].jp_value);
405 #if (defined INET || defined INET6)
409 if (ip4_ok && !strcmp(params[n].jp_name, "ip4.addr")) {
410 emit_ip_addr_list(AF_INET, "ipv4_addrs", params + n);
415 if (ip6_ok && !strcmp(params[n].jp_name, "ip6.addr")) {
416 emit_ip_addr_list(AF_INET6, "ipv6_addrs", params + n);
420 } else if (pflags & PRINT_DEFAULT) {
421 if (pflags & PRINT_JAIL_NAME)
422 xo_emit("{P: }{:name/%-15s/%s}{P: }",
423 (char *)params[0].jp_value);
425 xo_emit("{:jid/%6d}{P: }", *(int *)params[0].jp_value);
426 xo_emit("{:ipv4/%-15.15s/%s}{P: }{:hostname/%-29.29s/%s}{P: }{:path/%.74s/%s}\n",
428 (!ip4_ok || params[1].jp_valuelen == 0) ? ""
429 : inet_ntoa(*(struct in_addr *)params[1].jp_value),
430 (char *)params[2-!ip4_ok].jp_value,
431 (char *)params[3-!ip4_ok].jp_value);
434 (char *)params[1].jp_value,
435 (char *)params[2].jp_value);
438 param_values = alloca(nparams * sizeof(*param_values));
439 for (i = 0; i < nparams; i++) {
440 if (!(params[i].jp_flags & JP_USER))
442 param_values[i] = jailparam_export(params + i);
443 if (param_values[i] == NULL)
444 xo_errx(1, "%s", jail_errmsg);
446 for (i = spc = 0; i < nparams; i++) {
447 if (!(params[i].jp_flags & JP_USER))
449 if ((pflags & PRINT_SKIP) &&
450 ((!(params[i].jp_ctltype &
451 (CTLFLAG_WR | CTLFLAG_TUN))) ||
452 (param_parent[i] >= 0 &&
453 *(int *)params[param_parent[i]].jp_value !=
460 if (pflags & PRINT_NAMEVAL) {
462 * Generally "name=value", but for booleans
463 * either "name" or "noname".
465 if (params[i].jp_flags &
466 (JP_BOOL | JP_NOBOOL)) {
467 if (*(int *)params[i].jp_value) {
468 asprintf(&xo_nname, "{en:%s/true}", params[i].jp_name);
470 xo_emit("{d:/%s}", params[i].jp_name);
473 nname = (params[i].jp_flags &
475 nononame(params[i].jp_name)
476 : noname(params[i].jp_name);
477 if (params[i].jp_flags & JP_NOBOOL) {
478 asprintf(&xo_nname, "{en:%s/true}", params[i].jp_name);
481 asprintf(&xo_nname, "{en:%s/false}", params[i].jp_name);
484 xo_emit("{d:/%s}", nname);
490 xo_emit("{d:%s}=", params[i].jp_name);
492 if (!special_print(pflags, params + i))
493 quoted_print(pflags, params[i].jp_name, param_values[i]);
496 for (i = 0; i < nparams; i++)
497 if (params[i].jp_flags & JP_USER)
498 free(param_values[i]);
501 xo_close_instance("jail");
506 quoted_print(int pflags, char *name, char *value)
511 /* An empty string needs quoting. */
513 xo_emit("{ea:/%s}{da:/\"\"}", name, value, name);
518 * The value will be surrounded by quotes if it contains spaces
521 qc = strchr(p, '\'') ? '"'
522 : strchr(p, '"') ? '\''
523 : strchr(p, ' ') || strchr(p, '\t') ? '"'
526 if (qc && pflags & PRINT_QUOTED)
527 xo_emit("{P:/%c}", qc);
529 xo_emit("{a:/%s}", name, value);
531 if (qc && pflags & PRINT_QUOTED)
532 xo_emit("{P:/%c}", qc);
536 special_print(int pflags, struct jailparam *param)
540 switch (xo_get_style(NULL)) {
549 if (!ip_as_list && param->jp_valuelen == 0) {
550 if (pflags & PRINT_QUOTED)
552 else if (!(pflags & PRINT_NAMEVAL))
554 } else if (ip_as_list && !strcmp(param->jp_name, "ip4.addr")) {
555 emit_ip_addr_list(AF_INET, param->jp_name, param);
556 } else if (ip_as_list && !strcmp(param->jp_name, "ip6.addr")) {
557 emit_ip_addr_list(AF_INET6, param->jp_name, param);
566 emit_ip_addr_list(int af_family, const char *list_name, struct jailparam *param)
568 char ipbuf[INET6_ADDRSTRLEN];
570 const char *emit_str;
575 addr_len = sizeof(struct in_addr);
576 emit_str = "{P: }{ql:ipv4_addr}{P:\n}";
579 addr_len = sizeof(struct in6_addr);
580 emit_str = "{P: }{ql:ipv6_addr}{P:\n}";
583 xo_err(1, "unsupported af_family");
587 count = param->jp_valuelen / addr_len;
589 xo_open_list(list_name);
590 for (ai = 0; ai < count; ai++) {
591 if (inet_ntop(af_family,
592 ((uint8_t *)param->jp_value) + addr_len * ai,
593 ipbuf, sizeof(ipbuf)) == NULL) {
594 xo_err(1, "inet_ntop");
596 xo_emit(emit_str, ipbuf);
599 xo_close_list(list_name);