]>
Commit | Line | Data |
---|---|---|
34dc7c2f BB |
1 | /* |
2 | * CDDL HEADER START | |
3 | * | |
4 | * The contents of this file are subject to the terms of the | |
5 | * Common Development and Distribution License (the "License"). | |
6 | * You may not use this file except in compliance with the License. | |
7 | * | |
8 | * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE | |
9 | * or http://www.opensolaris.org/os/licensing. | |
10 | * See the License for the specific language governing permissions | |
11 | * and limitations under the License. | |
12 | * | |
13 | * When distributing Covered Code, include this CDDL HEADER in each | |
14 | * file and include the License file at usr/src/OPENSOLARIS.LICENSE. | |
15 | * If applicable, add the following below this CDDL HEADER, with the | |
16 | * fields enclosed by brackets "[]" replaced with your own identifying | |
17 | * information: Portions Copyright [yyyy] [name of copyright owner] | |
18 | * | |
19 | * CDDL HEADER END | |
20 | */ | |
9ae529ec | 21 | |
34dc7c2f | 22 | /* |
428870ff | 23 | * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved. |
c14ca145 | 24 | * Copyright 2020 Joyent, Inc. All rights reserved. |
c15d36c6 | 25 | * Copyright (c) 2011, 2020 by Delphix. All rights reserved. |
23d70cde | 26 | * Copyright 2016 Igor Kozhukhov <ikozhukhov@gmail.com> |
0ea05c64 | 27 | * Copyright (c) 2017 Datto Inc. |
8fb79fdd AJ |
28 | * Copyright (c) 2020 The FreeBSD Foundation |
29 | * | |
30 | * Portions of this software were developed by Allan Jude | |
31 | * under sponsorship from the FreeBSD Foundation. | |
34dc7c2f BB |
32 | */ |
33 | ||
34dc7c2f BB |
34 | /* |
35 | * Internal utility routines for the ZFS library. | |
36 | */ | |
37 | ||
38 | #include <errno.h> | |
39 | #include <fcntl.h> | |
40 | #include <libintl.h> | |
41 | #include <stdarg.h> | |
42 | #include <stdio.h> | |
43 | #include <stdlib.h> | |
44 | #include <strings.h> | |
45 | #include <unistd.h> | |
34dc7c2f | 46 | #include <math.h> |
d603ed6c | 47 | #include <sys/stat.h> |
34dc7c2f BB |
48 | #include <sys/mnttab.h> |
49 | #include <sys/mntent.h> | |
50 | #include <sys/types.h> | |
120ff39a | 51 | #include <sys/wait.h> |
34dc7c2f BB |
52 | |
53 | #include <libzfs.h> | |
6f1ffb06 | 54 | #include <libzfs_core.h> |
34dc7c2f BB |
55 | |
56 | #include "libzfs_impl.h" | |
57 | #include "zfs_prop.h" | |
9ae529ec | 58 | #include "zfeature_common.h" |
dc03fa30 | 59 | #include <zfs_fletcher.h> |
e89f1295 | 60 | #include <libzutil.h> |
34dc7c2f | 61 | |
c14ca145 JK |
62 | /* |
63 | * We only care about the scheme in order to match the scheme | |
64 | * with the handler. Each handler should validate the full URI | |
65 | * as necessary. | |
66 | */ | |
67 | #define URI_REGEX "^\\([A-Za-z][A-Za-z0-9+.\\-]*\\):" | |
73cdcc63 | 68 | |
34dc7c2f BB |
69 | int |
70 | libzfs_errno(libzfs_handle_t *hdl) | |
71 | { | |
72 | return (hdl->libzfs_error); | |
73 | } | |
74 | ||
75 | const char * | |
76 | libzfs_error_action(libzfs_handle_t *hdl) | |
77 | { | |
78 | return (hdl->libzfs_action); | |
79 | } | |
80 | ||
81 | const char * | |
82 | libzfs_error_description(libzfs_handle_t *hdl) | |
83 | { | |
84 | if (hdl->libzfs_desc[0] != '\0') | |
85 | return (hdl->libzfs_desc); | |
86 | ||
87 | switch (hdl->libzfs_error) { | |
88 | case EZFS_NOMEM: | |
89 | return (dgettext(TEXT_DOMAIN, "out of memory")); | |
90 | case EZFS_BADPROP: | |
91 | return (dgettext(TEXT_DOMAIN, "invalid property value")); | |
92 | case EZFS_PROPREADONLY: | |
572e2857 | 93 | return (dgettext(TEXT_DOMAIN, "read-only property")); |
34dc7c2f BB |
94 | case EZFS_PROPTYPE: |
95 | return (dgettext(TEXT_DOMAIN, "property doesn't apply to " | |
96 | "datasets of this type")); | |
97 | case EZFS_PROPNONINHERIT: | |
98 | return (dgettext(TEXT_DOMAIN, "property cannot be inherited")); | |
99 | case EZFS_PROPSPACE: | |
100 | return (dgettext(TEXT_DOMAIN, "invalid quota or reservation")); | |
101 | case EZFS_BADTYPE: | |
102 | return (dgettext(TEXT_DOMAIN, "operation not applicable to " | |
103 | "datasets of this type")); | |
104 | case EZFS_BUSY: | |
105 | return (dgettext(TEXT_DOMAIN, "pool or dataset is busy")); | |
106 | case EZFS_EXISTS: | |
107 | return (dgettext(TEXT_DOMAIN, "pool or dataset exists")); | |
108 | case EZFS_NOENT: | |
109 | return (dgettext(TEXT_DOMAIN, "no such pool or dataset")); | |
110 | case EZFS_BADSTREAM: | |
111 | return (dgettext(TEXT_DOMAIN, "invalid backup stream")); | |
112 | case EZFS_DSREADONLY: | |
572e2857 | 113 | return (dgettext(TEXT_DOMAIN, "dataset is read-only")); |
34dc7c2f BB |
114 | case EZFS_VOLTOOBIG: |
115 | return (dgettext(TEXT_DOMAIN, "volume size exceeds limit for " | |
116 | "this system")); | |
34dc7c2f BB |
117 | case EZFS_INVALIDNAME: |
118 | return (dgettext(TEXT_DOMAIN, "invalid name")); | |
119 | case EZFS_BADRESTORE: | |
120 | return (dgettext(TEXT_DOMAIN, "unable to restore to " | |
121 | "destination")); | |
122 | case EZFS_BADBACKUP: | |
123 | return (dgettext(TEXT_DOMAIN, "backup failed")); | |
124 | case EZFS_BADTARGET: | |
125 | return (dgettext(TEXT_DOMAIN, "invalid target vdev")); | |
126 | case EZFS_NODEVICE: | |
127 | return (dgettext(TEXT_DOMAIN, "no such device in pool")); | |
128 | case EZFS_BADDEV: | |
129 | return (dgettext(TEXT_DOMAIN, "invalid device")); | |
130 | case EZFS_NOREPLICAS: | |
131 | return (dgettext(TEXT_DOMAIN, "no valid replicas")); | |
132 | case EZFS_RESILVERING: | |
133 | return (dgettext(TEXT_DOMAIN, "currently resilvering")); | |
134 | case EZFS_BADVERSION: | |
9ae529ec CS |
135 | return (dgettext(TEXT_DOMAIN, "unsupported version or " |
136 | "feature")); | |
34dc7c2f BB |
137 | case EZFS_POOLUNAVAIL: |
138 | return (dgettext(TEXT_DOMAIN, "pool is unavailable")); | |
139 | case EZFS_DEVOVERFLOW: | |
140 | return (dgettext(TEXT_DOMAIN, "too many devices in one vdev")); | |
141 | case EZFS_BADPATH: | |
142 | return (dgettext(TEXT_DOMAIN, "must be an absolute path")); | |
143 | case EZFS_CROSSTARGET: | |
144 | return (dgettext(TEXT_DOMAIN, "operation crosses datasets or " | |
145 | "pools")); | |
146 | case EZFS_ZONED: | |
147 | return (dgettext(TEXT_DOMAIN, "dataset in use by local zone")); | |
148 | case EZFS_MOUNTFAILED: | |
149 | return (dgettext(TEXT_DOMAIN, "mount failed")); | |
150 | case EZFS_UMOUNTFAILED: | |
151 | return (dgettext(TEXT_DOMAIN, "umount failed")); | |
152 | case EZFS_UNSHARENFSFAILED: | |
153 | return (dgettext(TEXT_DOMAIN, "unshare(1M) failed")); | |
154 | case EZFS_SHARENFSFAILED: | |
155 | return (dgettext(TEXT_DOMAIN, "share(1M) failed")); | |
156 | case EZFS_UNSHARESMBFAILED: | |
157 | return (dgettext(TEXT_DOMAIN, "smb remove share failed")); | |
158 | case EZFS_SHARESMBFAILED: | |
159 | return (dgettext(TEXT_DOMAIN, "smb add share failed")); | |
34dc7c2f BB |
160 | case EZFS_PERM: |
161 | return (dgettext(TEXT_DOMAIN, "permission denied")); | |
162 | case EZFS_NOSPC: | |
163 | return (dgettext(TEXT_DOMAIN, "out of space")); | |
428870ff BB |
164 | case EZFS_FAULT: |
165 | return (dgettext(TEXT_DOMAIN, "bad address")); | |
34dc7c2f BB |
166 | case EZFS_IO: |
167 | return (dgettext(TEXT_DOMAIN, "I/O error")); | |
168 | case EZFS_INTR: | |
169 | return (dgettext(TEXT_DOMAIN, "signal received")); | |
170 | case EZFS_ISSPARE: | |
171 | return (dgettext(TEXT_DOMAIN, "device is reserved as a hot " | |
172 | "spare")); | |
173 | case EZFS_INVALCONFIG: | |
174 | return (dgettext(TEXT_DOMAIN, "invalid vdev configuration")); | |
175 | case EZFS_RECURSIVE: | |
176 | return (dgettext(TEXT_DOMAIN, "recursive dataset dependency")); | |
177 | case EZFS_NOHISTORY: | |
178 | return (dgettext(TEXT_DOMAIN, "no history available")); | |
34dc7c2f BB |
179 | case EZFS_POOLPROPS: |
180 | return (dgettext(TEXT_DOMAIN, "failed to retrieve " | |
181 | "pool properties")); | |
182 | case EZFS_POOL_NOTSUP: | |
183 | return (dgettext(TEXT_DOMAIN, "operation not supported " | |
184 | "on this type of pool")); | |
185 | case EZFS_POOL_INVALARG: | |
186 | return (dgettext(TEXT_DOMAIN, "invalid argument for " | |
187 | "this pool operation")); | |
188 | case EZFS_NAMETOOLONG: | |
189 | return (dgettext(TEXT_DOMAIN, "dataset name is too long")); | |
190 | case EZFS_OPENFAILED: | |
191 | return (dgettext(TEXT_DOMAIN, "open failed")); | |
192 | case EZFS_NOCAP: | |
193 | return (dgettext(TEXT_DOMAIN, | |
194 | "disk capacity information could not be retrieved")); | |
195 | case EZFS_LABELFAILED: | |
196 | return (dgettext(TEXT_DOMAIN, "write of label failed")); | |
197 | case EZFS_BADWHO: | |
198 | return (dgettext(TEXT_DOMAIN, "invalid user/group")); | |
199 | case EZFS_BADPERM: | |
200 | return (dgettext(TEXT_DOMAIN, "invalid permission")); | |
201 | case EZFS_BADPERMSET: | |
202 | return (dgettext(TEXT_DOMAIN, "invalid permission set name")); | |
203 | case EZFS_NODELEGATION: | |
204 | return (dgettext(TEXT_DOMAIN, "delegated administration is " | |
205 | "disabled on pool")); | |
34dc7c2f BB |
206 | case EZFS_BADCACHE: |
207 | return (dgettext(TEXT_DOMAIN, "invalid or missing cache file")); | |
208 | case EZFS_ISL2CACHE: | |
209 | return (dgettext(TEXT_DOMAIN, "device is in use as a cache")); | |
210 | case EZFS_VDEVNOTSUP: | |
211 | return (dgettext(TEXT_DOMAIN, "vdev specification is not " | |
212 | "supported")); | |
b128c09f BB |
213 | case EZFS_NOTSUP: |
214 | return (dgettext(TEXT_DOMAIN, "operation not supported " | |
215 | "on this dataset")); | |
b83a0e2d DB |
216 | case EZFS_IOC_NOTSUPPORTED: |
217 | return (dgettext(TEXT_DOMAIN, "operation not supported by " | |
218 | "zfs kernel module")); | |
b128c09f BB |
219 | case EZFS_ACTIVE_SPARE: |
220 | return (dgettext(TEXT_DOMAIN, "pool has active shared spare " | |
221 | "device")); | |
9babb374 BB |
222 | case EZFS_UNPLAYED_LOGS: |
223 | return (dgettext(TEXT_DOMAIN, "log device has unplayed intent " | |
224 | "logs")); | |
45d1cae3 BB |
225 | case EZFS_REFTAG_RELE: |
226 | return (dgettext(TEXT_DOMAIN, "no such tag on this dataset")); | |
227 | case EZFS_REFTAG_HOLD: | |
228 | return (dgettext(TEXT_DOMAIN, "tag already exists on this " | |
229 | "dataset")); | |
428870ff BB |
230 | case EZFS_TAGTOOLONG: |
231 | return (dgettext(TEXT_DOMAIN, "tag too long")); | |
232 | case EZFS_PIPEFAILED: | |
233 | return (dgettext(TEXT_DOMAIN, "pipe create failed")); | |
234 | case EZFS_THREADCREATEFAILED: | |
235 | return (dgettext(TEXT_DOMAIN, "thread create failed")); | |
236 | case EZFS_POSTSPLIT_ONLINE: | |
237 | return (dgettext(TEXT_DOMAIN, "disk was split from this pool " | |
238 | "into a new one")); | |
0ea05c64 AP |
239 | case EZFS_SCRUB_PAUSED: |
240 | return (dgettext(TEXT_DOMAIN, "scrub is paused; " | |
241 | "use 'zpool scrub' to resume")); | |
428870ff BB |
242 | case EZFS_SCRUBBING: |
243 | return (dgettext(TEXT_DOMAIN, "currently scrubbing; " | |
244 | "use 'zpool scrub -s' to cancel current scrub")); | |
245 | case EZFS_NO_SCRUB: | |
246 | return (dgettext(TEXT_DOMAIN, "there is no active scrub")); | |
572e2857 BB |
247 | case EZFS_DIFF: |
248 | return (dgettext(TEXT_DOMAIN, "unable to generate diffs")); | |
249 | case EZFS_DIFFDATA: | |
250 | return (dgettext(TEXT_DOMAIN, "invalid diff data")); | |
251 | case EZFS_POOLREADONLY: | |
252 | return (dgettext(TEXT_DOMAIN, "pool is read-only")); | |
a1d477c2 MA |
253 | case EZFS_NO_PENDING: |
254 | return (dgettext(TEXT_DOMAIN, "operation is not " | |
255 | "in progress")); | |
d2734cce SD |
256 | case EZFS_CHECKPOINT_EXISTS: |
257 | return (dgettext(TEXT_DOMAIN, "checkpoint exists")); | |
258 | case EZFS_DISCARDING_CHECKPOINT: | |
259 | return (dgettext(TEXT_DOMAIN, "currently discarding " | |
260 | "checkpoint")); | |
261 | case EZFS_NO_CHECKPOINT: | |
262 | return (dgettext(TEXT_DOMAIN, "checkpoint does not exist")); | |
263 | case EZFS_DEVRM_IN_PROGRESS: | |
264 | return (dgettext(TEXT_DOMAIN, "device removal in progress")); | |
265 | case EZFS_VDEV_TOO_BIG: | |
266 | return (dgettext(TEXT_DOMAIN, "device exceeds supported size")); | |
379ca9cf OF |
267 | case EZFS_ACTIVE_POOL: |
268 | return (dgettext(TEXT_DOMAIN, "pool is imported on a " | |
269 | "different host")); | |
b5256303 TC |
270 | case EZFS_CRYPTOFAILED: |
271 | return (dgettext(TEXT_DOMAIN, "encryption failure")); | |
619f0976 GW |
272 | case EZFS_TOOMANY: |
273 | return (dgettext(TEXT_DOMAIN, "argument list too long")); | |
274 | case EZFS_INITIALIZING: | |
275 | return (dgettext(TEXT_DOMAIN, "currently initializing")); | |
276 | case EZFS_NO_INITIALIZE: | |
277 | return (dgettext(TEXT_DOMAIN, "there is no active " | |
278 | "initialization")); | |
d8d418ff | 279 | case EZFS_WRONG_PARENT: |
280 | return (dgettext(TEXT_DOMAIN, "invalid parent dataset")); | |
1b939560 BB |
281 | case EZFS_TRIMMING: |
282 | return (dgettext(TEXT_DOMAIN, "currently trimming")); | |
283 | case EZFS_NO_TRIM: | |
284 | return (dgettext(TEXT_DOMAIN, "there is no active trim")); | |
285 | case EZFS_TRIM_NOTSUP: | |
286 | return (dgettext(TEXT_DOMAIN, "trim operations are not " | |
287 | "supported by this device")); | |
fa241660 TC |
288 | case EZFS_NO_RESILVER_DEFER: |
289 | return (dgettext(TEXT_DOMAIN, "this action requires the " | |
290 | "resilver_defer feature")); | |
43a85362 SD |
291 | case EZFS_EXPORT_IN_PROGRESS: |
292 | return (dgettext(TEXT_DOMAIN, "pool export in progress")); | |
9a49d3f3 BB |
293 | case EZFS_REBUILDING: |
294 | return (dgettext(TEXT_DOMAIN, "currently sequentially " | |
295 | "resilvering")); | |
34dc7c2f BB |
296 | case EZFS_UNKNOWN: |
297 | return (dgettext(TEXT_DOMAIN, "unknown error")); | |
298 | default: | |
299 | assert(hdl->libzfs_error == 0); | |
300 | return (dgettext(TEXT_DOMAIN, "no error")); | |
301 | } | |
302 | } | |
303 | ||
304 | /*PRINTFLIKE2*/ | |
305 | void | |
306 | zfs_error_aux(libzfs_handle_t *hdl, const char *fmt, ...) | |
307 | { | |
308 | va_list ap; | |
309 | ||
310 | va_start(ap, fmt); | |
311 | ||
312 | (void) vsnprintf(hdl->libzfs_desc, sizeof (hdl->libzfs_desc), | |
313 | fmt, ap); | |
314 | hdl->libzfs_desc_active = 1; | |
315 | ||
316 | va_end(ap); | |
317 | } | |
318 | ||
319 | static void | |
320 | zfs_verror(libzfs_handle_t *hdl, int error, const char *fmt, va_list ap) | |
321 | { | |
322 | (void) vsnprintf(hdl->libzfs_action, sizeof (hdl->libzfs_action), | |
323 | fmt, ap); | |
324 | hdl->libzfs_error = error; | |
325 | ||
326 | if (hdl->libzfs_desc_active) | |
327 | hdl->libzfs_desc_active = 0; | |
328 | else | |
329 | hdl->libzfs_desc[0] = '\0'; | |
330 | ||
331 | if (hdl->libzfs_printerr) { | |
332 | if (error == EZFS_UNKNOWN) { | |
333 | (void) fprintf(stderr, dgettext(TEXT_DOMAIN, "internal " | |
24f98ed3 AJ |
334 | "error: %s: %s\n"), hdl->libzfs_action, |
335 | libzfs_error_description(hdl)); | |
34dc7c2f BB |
336 | abort(); |
337 | } | |
338 | ||
339 | (void) fprintf(stderr, "%s: %s\n", hdl->libzfs_action, | |
340 | libzfs_error_description(hdl)); | |
341 | if (error == EZFS_NOMEM) | |
342 | exit(1); | |
343 | } | |
344 | } | |
345 | ||
346 | int | |
347 | zfs_error(libzfs_handle_t *hdl, int error, const char *msg) | |
348 | { | |
349 | return (zfs_error_fmt(hdl, error, "%s", msg)); | |
350 | } | |
351 | ||
352 | /*PRINTFLIKE3*/ | |
353 | int | |
354 | zfs_error_fmt(libzfs_handle_t *hdl, int error, const char *fmt, ...) | |
355 | { | |
356 | va_list ap; | |
357 | ||
358 | va_start(ap, fmt); | |
359 | ||
360 | zfs_verror(hdl, error, fmt, ap); | |
361 | ||
362 | va_end(ap); | |
363 | ||
364 | return (-1); | |
365 | } | |
366 | ||
367 | static int | |
368 | zfs_common_error(libzfs_handle_t *hdl, int error, const char *fmt, | |
369 | va_list ap) | |
370 | { | |
371 | switch (error) { | |
372 | case EPERM: | |
373 | case EACCES: | |
374 | zfs_verror(hdl, EZFS_PERM, fmt, ap); | |
375 | return (-1); | |
376 | ||
377 | case ECANCELED: | |
378 | zfs_verror(hdl, EZFS_NODELEGATION, fmt, ap); | |
379 | return (-1); | |
380 | ||
381 | case EIO: | |
382 | zfs_verror(hdl, EZFS_IO, fmt, ap); | |
383 | return (-1); | |
384 | ||
428870ff BB |
385 | case EFAULT: |
386 | zfs_verror(hdl, EZFS_FAULT, fmt, ap); | |
387 | return (-1); | |
388 | ||
34dc7c2f BB |
389 | case EINTR: |
390 | zfs_verror(hdl, EZFS_INTR, fmt, ap); | |
391 | return (-1); | |
392 | } | |
393 | ||
394 | return (0); | |
395 | } | |
396 | ||
397 | int | |
398 | zfs_standard_error(libzfs_handle_t *hdl, int error, const char *msg) | |
399 | { | |
400 | return (zfs_standard_error_fmt(hdl, error, "%s", msg)); | |
401 | } | |
402 | ||
403 | /*PRINTFLIKE3*/ | |
404 | int | |
405 | zfs_standard_error_fmt(libzfs_handle_t *hdl, int error, const char *fmt, ...) | |
406 | { | |
407 | va_list ap; | |
408 | ||
409 | va_start(ap, fmt); | |
410 | ||
411 | if (zfs_common_error(hdl, error, fmt, ap) != 0) { | |
412 | va_end(ap); | |
413 | return (-1); | |
414 | } | |
415 | ||
416 | switch (error) { | |
417 | case ENXIO: | |
418 | case ENODEV: | |
330d06f9 | 419 | case EPIPE: |
34dc7c2f BB |
420 | zfs_verror(hdl, EZFS_IO, fmt, ap); |
421 | break; | |
422 | ||
423 | case ENOENT: | |
424 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
425 | "dataset does not exist")); | |
426 | zfs_verror(hdl, EZFS_NOENT, fmt, ap); | |
427 | break; | |
428 | ||
429 | case ENOSPC: | |
430 | case EDQUOT: | |
431 | zfs_verror(hdl, EZFS_NOSPC, fmt, ap); | |
b264d9b3 | 432 | break; |
34dc7c2f BB |
433 | |
434 | case EEXIST: | |
435 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
436 | "dataset already exists")); | |
437 | zfs_verror(hdl, EZFS_EXISTS, fmt, ap); | |
438 | break; | |
439 | ||
440 | case EBUSY: | |
441 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
442 | "dataset is busy")); | |
443 | zfs_verror(hdl, EZFS_BUSY, fmt, ap); | |
444 | break; | |
445 | case EROFS: | |
572e2857 | 446 | zfs_verror(hdl, EZFS_POOLREADONLY, fmt, ap); |
34dc7c2f BB |
447 | break; |
448 | case ENAMETOOLONG: | |
449 | zfs_verror(hdl, EZFS_NAMETOOLONG, fmt, ap); | |
450 | break; | |
451 | case ENOTSUP: | |
452 | zfs_verror(hdl, EZFS_BADVERSION, fmt, ap); | |
453 | break; | |
9babb374 BB |
454 | case EAGAIN: |
455 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
456 | "pool I/O is currently suspended")); | |
457 | zfs_verror(hdl, EZFS_POOLUNAVAIL, fmt, ap); | |
458 | break; | |
379ca9cf OF |
459 | case EREMOTEIO: |
460 | zfs_verror(hdl, EZFS_ACTIVE_POOL, fmt, ap); | |
461 | break; | |
30af21b0 | 462 | case ZFS_ERR_UNKNOWN_SEND_STREAM_FEATURE: |
b83a0e2d DB |
463 | case ZFS_ERR_IOC_CMD_UNAVAIL: |
464 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, "the loaded zfs " | |
465 | "module does not support this operation. A reboot may " | |
466 | "be required to enable this operation.")); | |
467 | zfs_verror(hdl, EZFS_IOC_NOTSUPPORTED, fmt, ap); | |
468 | break; | |
469 | case ZFS_ERR_IOC_ARG_UNAVAIL: | |
470 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, "the loaded zfs " | |
471 | "module does not support an option for this operation. " | |
472 | "A reboot may be required to enable this option.")); | |
473 | zfs_verror(hdl, EZFS_IOC_NOTSUPPORTED, fmt, ap); | |
474 | break; | |
475 | case ZFS_ERR_IOC_ARG_REQUIRED: | |
476 | case ZFS_ERR_IOC_ARG_BADTYPE: | |
477 | zfs_verror(hdl, EZFS_IOC_NOTSUPPORTED, fmt, ap); | |
478 | break; | |
d8d418ff | 479 | case ZFS_ERR_WRONG_PARENT: |
480 | zfs_verror(hdl, EZFS_WRONG_PARENT, fmt, ap); | |
481 | break; | |
8fb79fdd AJ |
482 | case ZFS_ERR_BADPROP: |
483 | zfs_verror(hdl, EZFS_BADPROP, fmt, ap); | |
484 | break; | |
34dc7c2f | 485 | default: |
428870ff | 486 | zfs_error_aux(hdl, strerror(error)); |
34dc7c2f BB |
487 | zfs_verror(hdl, EZFS_UNKNOWN, fmt, ap); |
488 | break; | |
489 | } | |
490 | ||
491 | va_end(ap); | |
492 | return (-1); | |
493 | } | |
494 | ||
0ce2de63 AS |
495 | void |
496 | zfs_setprop_error(libzfs_handle_t *hdl, zfs_prop_t prop, int err, | |
497 | char *errbuf) | |
498 | { | |
499 | switch (err) { | |
500 | ||
501 | case ENOSPC: | |
502 | /* | |
503 | * For quotas and reservations, ENOSPC indicates | |
504 | * something different; setting a quota or reservation | |
505 | * doesn't use any disk space. | |
506 | */ | |
507 | switch (prop) { | |
508 | case ZFS_PROP_QUOTA: | |
509 | case ZFS_PROP_REFQUOTA: | |
510 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
511 | "size is less than current used or " | |
512 | "reserved space")); | |
513 | (void) zfs_error(hdl, EZFS_PROPSPACE, errbuf); | |
514 | break; | |
515 | ||
516 | case ZFS_PROP_RESERVATION: | |
517 | case ZFS_PROP_REFRESERVATION: | |
518 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
519 | "size is greater than available space")); | |
520 | (void) zfs_error(hdl, EZFS_PROPSPACE, errbuf); | |
521 | break; | |
522 | ||
523 | default: | |
524 | (void) zfs_standard_error(hdl, err, errbuf); | |
525 | break; | |
526 | } | |
527 | break; | |
528 | ||
529 | case EBUSY: | |
530 | (void) zfs_standard_error(hdl, EBUSY, errbuf); | |
531 | break; | |
532 | ||
533 | case EROFS: | |
534 | (void) zfs_error(hdl, EZFS_DSREADONLY, errbuf); | |
535 | break; | |
536 | ||
537 | case E2BIG: | |
538 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
539 | "property value too long")); | |
540 | (void) zfs_error(hdl, EZFS_BADPROP, errbuf); | |
541 | break; | |
542 | ||
543 | case ENOTSUP: | |
544 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
545 | "pool and or dataset must be upgraded to set this " | |
546 | "property or value")); | |
547 | (void) zfs_error(hdl, EZFS_BADVERSION, errbuf); | |
548 | break; | |
549 | ||
550 | case ERANGE: | |
551 | if (prop == ZFS_PROP_COMPRESSION || | |
552 | prop == ZFS_PROP_DNODESIZE || | |
553 | prop == ZFS_PROP_RECORDSIZE) { | |
554 | (void) zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
555 | "property setting is not allowed on " | |
556 | "bootable datasets")); | |
557 | (void) zfs_error(hdl, EZFS_NOTSUP, errbuf); | |
558 | } else if (prop == ZFS_PROP_CHECKSUM || | |
559 | prop == ZFS_PROP_DEDUP) { | |
560 | (void) zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
561 | "property setting is not allowed on " | |
562 | "root pools")); | |
563 | (void) zfs_error(hdl, EZFS_NOTSUP, errbuf); | |
564 | } else { | |
565 | (void) zfs_standard_error(hdl, err, errbuf); | |
566 | } | |
567 | break; | |
568 | ||
569 | case EINVAL: | |
570 | if (prop == ZPROP_INVAL) { | |
571 | (void) zfs_error(hdl, EZFS_BADPROP, errbuf); | |
572 | } else { | |
573 | (void) zfs_standard_error(hdl, err, errbuf); | |
574 | } | |
575 | break; | |
576 | ||
8fb79fdd AJ |
577 | case ZFS_ERR_BADPROP: |
578 | (void) zfs_error(hdl, EZFS_BADPROP, errbuf); | |
579 | break; | |
580 | ||
0ce2de63 AS |
581 | case EACCES: |
582 | if (prop == ZFS_PROP_KEYLOCATION) { | |
583 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
584 | "keylocation may only be set on encryption roots")); | |
585 | (void) zfs_error(hdl, EZFS_BADPROP, errbuf); | |
586 | } else { | |
587 | (void) zfs_standard_error(hdl, err, errbuf); | |
588 | } | |
589 | break; | |
590 | ||
591 | case EOVERFLOW: | |
592 | /* | |
593 | * This platform can't address a volume this big. | |
594 | */ | |
595 | #ifdef _ILP32 | |
596 | if (prop == ZFS_PROP_VOLSIZE) { | |
597 | (void) zfs_error(hdl, EZFS_VOLTOOBIG, errbuf); | |
598 | break; | |
599 | } | |
600 | #endif | |
601 | /* FALLTHROUGH */ | |
602 | default: | |
603 | (void) zfs_standard_error(hdl, err, errbuf); | |
604 | } | |
605 | } | |
606 | ||
34dc7c2f BB |
607 | int |
608 | zpool_standard_error(libzfs_handle_t *hdl, int error, const char *msg) | |
609 | { | |
610 | return (zpool_standard_error_fmt(hdl, error, "%s", msg)); | |
611 | } | |
612 | ||
613 | /*PRINTFLIKE3*/ | |
614 | int | |
615 | zpool_standard_error_fmt(libzfs_handle_t *hdl, int error, const char *fmt, ...) | |
616 | { | |
617 | va_list ap; | |
618 | ||
619 | va_start(ap, fmt); | |
620 | ||
621 | if (zfs_common_error(hdl, error, fmt, ap) != 0) { | |
622 | va_end(ap); | |
623 | return (-1); | |
624 | } | |
625 | ||
626 | switch (error) { | |
627 | case ENODEV: | |
628 | zfs_verror(hdl, EZFS_NODEVICE, fmt, ap); | |
629 | break; | |
630 | ||
631 | case ENOENT: | |
632 | zfs_error_aux(hdl, | |
633 | dgettext(TEXT_DOMAIN, "no such pool or dataset")); | |
634 | zfs_verror(hdl, EZFS_NOENT, fmt, ap); | |
635 | break; | |
636 | ||
637 | case EEXIST: | |
638 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
639 | "pool already exists")); | |
640 | zfs_verror(hdl, EZFS_EXISTS, fmt, ap); | |
641 | break; | |
642 | ||
643 | case EBUSY: | |
644 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, "pool is busy")); | |
b128c09f | 645 | zfs_verror(hdl, EZFS_BUSY, fmt, ap); |
34dc7c2f BB |
646 | break; |
647 | ||
a1d477c2 MA |
648 | /* There is no pending operation to cancel */ |
649 | case ENOTACTIVE: | |
650 | zfs_verror(hdl, EZFS_NO_PENDING, fmt, ap); | |
651 | break; | |
652 | ||
34dc7c2f BB |
653 | case ENXIO: |
654 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
655 | "one or more devices is currently unavailable")); | |
656 | zfs_verror(hdl, EZFS_BADDEV, fmt, ap); | |
657 | break; | |
658 | ||
659 | case ENAMETOOLONG: | |
660 | zfs_verror(hdl, EZFS_DEVOVERFLOW, fmt, ap); | |
661 | break; | |
662 | ||
663 | case ENOTSUP: | |
664 | zfs_verror(hdl, EZFS_POOL_NOTSUP, fmt, ap); | |
665 | break; | |
666 | ||
667 | case EINVAL: | |
668 | zfs_verror(hdl, EZFS_POOL_INVALARG, fmt, ap); | |
669 | break; | |
670 | ||
671 | case ENOSPC: | |
672 | case EDQUOT: | |
673 | zfs_verror(hdl, EZFS_NOSPC, fmt, ap); | |
674 | return (-1); | |
572e2857 | 675 | |
9babb374 BB |
676 | case EAGAIN: |
677 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
678 | "pool I/O is currently suspended")); | |
679 | zfs_verror(hdl, EZFS_POOLUNAVAIL, fmt, ap); | |
680 | break; | |
34dc7c2f | 681 | |
572e2857 BB |
682 | case EROFS: |
683 | zfs_verror(hdl, EZFS_POOLREADONLY, fmt, ap); | |
684 | break; | |
385f9691 D |
685 | case EDOM: |
686 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
687 | "block size out of range or does not match")); | |
688 | zfs_verror(hdl, EZFS_BADPROP, fmt, ap); | |
689 | break; | |
379ca9cf OF |
690 | case EREMOTEIO: |
691 | zfs_verror(hdl, EZFS_ACTIVE_POOL, fmt, ap); | |
692 | break; | |
d2734cce SD |
693 | case ZFS_ERR_CHECKPOINT_EXISTS: |
694 | zfs_verror(hdl, EZFS_CHECKPOINT_EXISTS, fmt, ap); | |
695 | break; | |
696 | case ZFS_ERR_DISCARDING_CHECKPOINT: | |
697 | zfs_verror(hdl, EZFS_DISCARDING_CHECKPOINT, fmt, ap); | |
698 | break; | |
699 | case ZFS_ERR_NO_CHECKPOINT: | |
700 | zfs_verror(hdl, EZFS_NO_CHECKPOINT, fmt, ap); | |
701 | break; | |
702 | case ZFS_ERR_DEVRM_IN_PROGRESS: | |
703 | zfs_verror(hdl, EZFS_DEVRM_IN_PROGRESS, fmt, ap); | |
704 | break; | |
705 | case ZFS_ERR_VDEV_TOO_BIG: | |
706 | zfs_verror(hdl, EZFS_VDEV_TOO_BIG, fmt, ap); | |
707 | break; | |
43a85362 SD |
708 | case ZFS_ERR_EXPORT_IN_PROGRESS: |
709 | zfs_verror(hdl, EZFS_EXPORT_IN_PROGRESS, fmt, ap); | |
710 | break; | |
9a49d3f3 BB |
711 | case ZFS_ERR_RESILVER_IN_PROGRESS: |
712 | zfs_verror(hdl, EZFS_RESILVERING, fmt, ap); | |
713 | break; | |
714 | case ZFS_ERR_REBUILD_IN_PROGRESS: | |
715 | zfs_verror(hdl, EZFS_REBUILDING, fmt, ap); | |
716 | break; | |
8fb79fdd AJ |
717 | case ZFS_ERR_BADPROP: |
718 | zfs_verror(hdl, EZFS_BADPROP, fmt, ap); | |
719 | break; | |
b83a0e2d DB |
720 | case ZFS_ERR_IOC_CMD_UNAVAIL: |
721 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, "the loaded zfs " | |
722 | "module does not support this operation. A reboot may " | |
723 | "be required to enable this operation.")); | |
724 | zfs_verror(hdl, EZFS_IOC_NOTSUPPORTED, fmt, ap); | |
725 | break; | |
726 | case ZFS_ERR_IOC_ARG_UNAVAIL: | |
727 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, "the loaded zfs " | |
728 | "module does not support an option for this operation. " | |
729 | "A reboot may be required to enable this option.")); | |
730 | zfs_verror(hdl, EZFS_IOC_NOTSUPPORTED, fmt, ap); | |
731 | break; | |
732 | case ZFS_ERR_IOC_ARG_REQUIRED: | |
733 | case ZFS_ERR_IOC_ARG_BADTYPE: | |
734 | zfs_verror(hdl, EZFS_IOC_NOTSUPPORTED, fmt, ap); | |
735 | break; | |
34dc7c2f BB |
736 | default: |
737 | zfs_error_aux(hdl, strerror(error)); | |
738 | zfs_verror(hdl, EZFS_UNKNOWN, fmt, ap); | |
739 | } | |
740 | ||
741 | va_end(ap); | |
742 | return (-1); | |
743 | } | |
744 | ||
745 | /* | |
746 | * Display an out of memory error message and abort the current program. | |
747 | */ | |
748 | int | |
749 | no_memory(libzfs_handle_t *hdl) | |
750 | { | |
751 | return (zfs_error(hdl, EZFS_NOMEM, "internal error")); | |
752 | } | |
753 | ||
754 | /* | |
755 | * A safe form of malloc() which will die if the allocation fails. | |
756 | */ | |
757 | void * | |
758 | zfs_alloc(libzfs_handle_t *hdl, size_t size) | |
759 | { | |
760 | void *data; | |
761 | ||
762 | if ((data = calloc(1, size)) == NULL) | |
763 | (void) no_memory(hdl); | |
764 | ||
765 | return (data); | |
766 | } | |
767 | ||
572e2857 BB |
768 | /* |
769 | * A safe form of asprintf() which will die if the allocation fails. | |
770 | */ | |
771 | /*PRINTFLIKE2*/ | |
772 | char * | |
773 | zfs_asprintf(libzfs_handle_t *hdl, const char *fmt, ...) | |
774 | { | |
775 | va_list ap; | |
776 | char *ret; | |
777 | int err; | |
778 | ||
779 | va_start(ap, fmt); | |
780 | ||
781 | err = vasprintf(&ret, fmt, ap); | |
782 | ||
783 | va_end(ap); | |
784 | ||
785 | if (err < 0) | |
786 | (void) no_memory(hdl); | |
787 | ||
788 | return (ret); | |
789 | } | |
790 | ||
34dc7c2f BB |
791 | /* |
792 | * A safe form of realloc(), which also zeroes newly allocated space. | |
793 | */ | |
794 | void * | |
795 | zfs_realloc(libzfs_handle_t *hdl, void *ptr, size_t oldsize, size_t newsize) | |
796 | { | |
797 | void *ret; | |
798 | ||
799 | if ((ret = realloc(ptr, newsize)) == NULL) { | |
800 | (void) no_memory(hdl); | |
34dc7c2f BB |
801 | return (NULL); |
802 | } | |
803 | ||
804 | bzero((char *)ret + oldsize, (newsize - oldsize)); | |
805 | return (ret); | |
806 | } | |
807 | ||
808 | /* | |
809 | * A safe form of strdup() which will die if the allocation fails. | |
810 | */ | |
811 | char * | |
812 | zfs_strdup(libzfs_handle_t *hdl, const char *str) | |
813 | { | |
814 | char *ret; | |
815 | ||
816 | if ((ret = strdup(str)) == NULL) | |
817 | (void) no_memory(hdl); | |
818 | ||
819 | return (ret); | |
820 | } | |
821 | ||
34dc7c2f BB |
822 | void |
823 | libzfs_print_on_error(libzfs_handle_t *hdl, boolean_t printerr) | |
824 | { | |
825 | hdl->libzfs_printerr = printerr; | |
826 | } | |
827 | ||
d6418de0 TH |
828 | /* |
829 | * Read lines from an open file descriptor and store them in an array of | |
830 | * strings until EOF. lines[] will be allocated and populated with all the | |
831 | * lines read. All newlines are replaced with NULL terminators for | |
832 | * convenience. lines[] must be freed after use with libzfs_free_str_array(). | |
833 | * | |
834 | * Returns the number of lines read. | |
835 | */ | |
836 | static int | |
837 | libzfs_read_stdout_from_fd(int fd, char **lines[]) | |
838 | { | |
839 | ||
840 | FILE *fp; | |
841 | int lines_cnt = 0; | |
842 | size_t len = 0; | |
843 | char *line = NULL; | |
844 | char **tmp_lines = NULL, **tmp; | |
845 | char *nl = NULL; | |
846 | int rc; | |
847 | ||
848 | fp = fdopen(fd, "r"); | |
849 | if (fp == NULL) | |
850 | return (0); | |
851 | while (1) { | |
852 | rc = getline(&line, &len, fp); | |
853 | if (rc == -1) | |
854 | break; | |
855 | ||
856 | tmp = realloc(tmp_lines, sizeof (*tmp_lines) * (lines_cnt + 1)); | |
857 | if (tmp == NULL) { | |
858 | /* Return the lines we were able to process */ | |
859 | break; | |
860 | } | |
861 | tmp_lines = tmp; | |
862 | ||
863 | /* Terminate newlines */ | |
864 | if ((nl = strchr(line, '\n')) != NULL) | |
865 | *nl = '\0'; | |
866 | tmp_lines[lines_cnt] = line; | |
867 | lines_cnt++; | |
868 | line = NULL; | |
869 | } | |
870 | fclose(fp); | |
871 | *lines = tmp_lines; | |
872 | return (lines_cnt); | |
873 | } | |
874 | ||
875 | static int | |
876 | libzfs_run_process_impl(const char *path, char *argv[], char *env[], int flags, | |
877 | char **lines[], int *lines_cnt) | |
4b1abce9 NB |
878 | { |
879 | pid_t pid; | |
65037d9b | 880 | int error, devnull_fd; |
d6418de0 TH |
881 | int link[2]; |
882 | ||
883 | /* | |
884 | * Setup a pipe between our child and parent process if we're | |
885 | * reading stdout. | |
886 | */ | |
887 | if ((lines != NULL) && pipe(link) == -1) | |
64b2e7d7 | 888 | return (-EPIPE); |
4b1abce9 NB |
889 | |
890 | pid = vfork(); | |
891 | if (pid == 0) { | |
d6418de0 | 892 | /* Child process */ |
3132cb39 GB |
893 | devnull_fd = open("/dev/null", O_WRONLY); |
894 | ||
895 | if (devnull_fd < 0) | |
896 | _exit(-1); | |
897 | ||
d6418de0 | 898 | if (!(flags & STDOUT_VERBOSE) && (lines == NULL)) |
3132cb39 | 899 | (void) dup2(devnull_fd, STDOUT_FILENO); |
d6418de0 TH |
900 | else if (lines != NULL) { |
901 | /* Save the output to lines[] */ | |
902 | dup2(link[1], STDOUT_FILENO); | |
903 | close(link[0]); | |
904 | close(link[1]); | |
905 | } | |
9ac97c2a BB |
906 | |
907 | if (!(flags & STDERR_VERBOSE)) | |
3132cb39 GB |
908 | (void) dup2(devnull_fd, STDERR_FILENO); |
909 | ||
910 | close(devnull_fd); | |
9ac97c2a | 911 | |
d6418de0 TH |
912 | if (flags & NO_DEFAULT_PATH) { |
913 | if (env == NULL) | |
914 | execv(path, argv); | |
915 | else | |
916 | execve(path, argv, env); | |
917 | } else { | |
918 | if (env == NULL) | |
919 | execvp(path, argv); | |
920 | else | |
921 | execvpe(path, argv, env); | |
922 | } | |
923 | ||
4b1abce9 NB |
924 | _exit(-1); |
925 | } else if (pid > 0) { | |
d6418de0 | 926 | /* Parent process */ |
4b1abce9 NB |
927 | int status; |
928 | ||
65037d9b | 929 | while ((error = waitpid(pid, &status, 0)) == -1 && |
02730c33 | 930 | errno == EINTR) { } |
65037d9b | 931 | if (error < 0 || !WIFEXITED(status)) |
d1d7e268 | 932 | return (-1); |
4b1abce9 | 933 | |
d6418de0 TH |
934 | if (lines != NULL) { |
935 | close(link[1]); | |
936 | *lines_cnt = libzfs_read_stdout_from_fd(link[0], lines); | |
937 | } | |
d1d7e268 | 938 | return (WEXITSTATUS(status)); |
4b1abce9 NB |
939 | } |
940 | ||
d1d7e268 | 941 | return (-1); |
4b1abce9 NB |
942 | } |
943 | ||
d6418de0 TH |
944 | int |
945 | libzfs_run_process(const char *path, char *argv[], int flags) | |
946 | { | |
947 | return (libzfs_run_process_impl(path, argv, NULL, flags, NULL, NULL)); | |
948 | } | |
949 | ||
950 | /* | |
951 | * Run a command and store its stdout lines in an array of strings (lines[]). | |
952 | * lines[] is allocated and populated for you, and the number of lines is set in | |
953 | * lines_cnt. lines[] must be freed after use with libzfs_free_str_array(). | |
954 | * All newlines (\n) in lines[] are terminated for convenience. | |
955 | */ | |
956 | int | |
957 | libzfs_run_process_get_stdout(const char *path, char *argv[], char *env[], | |
958 | char **lines[], int *lines_cnt) | |
959 | { | |
960 | return (libzfs_run_process_impl(path, argv, env, 0, lines, lines_cnt)); | |
961 | } | |
962 | ||
963 | /* | |
964 | * Same as libzfs_run_process_get_stdout(), but run without $PATH set. This | |
965 | * means that *path needs to be the full path to the executable. | |
966 | */ | |
967 | int | |
968 | libzfs_run_process_get_stdout_nopath(const char *path, char *argv[], | |
969 | char *env[], char **lines[], int *lines_cnt) | |
970 | { | |
971 | return (libzfs_run_process_impl(path, argv, env, NO_DEFAULT_PATH, | |
972 | lines, lines_cnt)); | |
973 | } | |
974 | ||
975 | /* | |
976 | * Free an array of strings. Free both the strings contained in the array and | |
977 | * the array itself. | |
978 | */ | |
979 | void | |
980 | libzfs_free_str_array(char **strs, int count) | |
981 | { | |
982 | while (--count >= 0) | |
983 | free(strs[count]); | |
984 | ||
985 | free(strs); | |
986 | } | |
987 | ||
988 | /* | |
989 | * Returns 1 if environment variable is set to "YES", "yes", "ON", "on", or | |
990 | * a non-zero number. | |
991 | * | |
992 | * Returns 0 otherwise. | |
993 | */ | |
994 | int | |
995 | libzfs_envvar_is_set(char *envvar) | |
996 | { | |
997 | char *env = getenv(envvar); | |
998 | if (env && (strtoul(env, NULL, 0) > 0 || | |
999 | (!strncasecmp(env, "YES", 3) && strnlen(env, 4) == 3) || | |
1000 | (!strncasecmp(env, "ON", 2) && strnlen(env, 3) == 2))) | |
1001 | return (1); | |
1002 | ||
1003 | return (0); | |
1004 | } | |
1005 | ||
34dc7c2f BB |
1006 | libzfs_handle_t * |
1007 | libzfs_init(void) | |
1008 | { | |
1009 | libzfs_handle_t *hdl; | |
87abfcba | 1010 | int error; |
7a6c12fd | 1011 | char *env; |
34dc7c2f | 1012 | |
e191b60d | 1013 | if ((error = libzfs_load_module()) != 0) { |
65037d9b | 1014 | errno = error; |
4b1abce9 NB |
1015 | return (NULL); |
1016 | } | |
1017 | ||
572e2857 | 1018 | if ((hdl = calloc(1, sizeof (libzfs_handle_t))) == NULL) { |
34dc7c2f BB |
1019 | return (NULL); |
1020 | } | |
1021 | ||
c14ca145 JK |
1022 | if (regcomp(&hdl->libzfs_urire, URI_REGEX, 0) != 0) { |
1023 | free(hdl); | |
1024 | return (NULL); | |
1025 | } | |
1026 | ||
9f0a21e6 | 1027 | if ((hdl->libzfs_fd = open(ZFS_DEV, O_RDWR|O_EXCL)) < 0) { |
34dc7c2f BB |
1028 | free(hdl); |
1029 | return (NULL); | |
1030 | } | |
1031 | ||
2eadf037 BB |
1032 | #ifdef HAVE_SETMNTENT |
1033 | if ((hdl->libzfs_mnttab = setmntent(MNTTAB, "r")) == NULL) { | |
1034 | #else | |
34dc7c2f | 1035 | if ((hdl->libzfs_mnttab = fopen(MNTTAB, "r")) == NULL) { |
2eadf037 | 1036 | #endif |
34dc7c2f BB |
1037 | (void) close(hdl->libzfs_fd); |
1038 | free(hdl); | |
1039 | return (NULL); | |
1040 | } | |
1041 | ||
6f1ffb06 MA |
1042 | if (libzfs_core_init() != 0) { |
1043 | (void) close(hdl->libzfs_fd); | |
1044 | (void) fclose(hdl->libzfs_mnttab); | |
6f1ffb06 MA |
1045 | free(hdl); |
1046 | return (NULL); | |
1047 | } | |
1048 | ||
34dc7c2f BB |
1049 | zfs_prop_init(); |
1050 | zpool_prop_init(); | |
9ae529ec | 1051 | zpool_feature_init(); |
9babb374 | 1052 | libzfs_mnttab_init(hdl); |
dc03fa30 | 1053 | fletcher_4_init(); |
34dc7c2f | 1054 | |
d99a0153 CW |
1055 | if (getenv("ZFS_PROP_DEBUG") != NULL) { |
1056 | hdl->libzfs_prop_debug = B_TRUE; | |
1057 | } | |
7a6c12fd AJ |
1058 | if ((env = getenv("ZFS_SENDRECV_MAX_NVLIST")) != NULL) { |
1059 | if ((error = zfs_nicestrtonum(hdl, env, | |
1060 | &hdl->libzfs_max_nvlist))) { | |
1061 | errno = error; | |
908d43d0 AJ |
1062 | (void) close(hdl->libzfs_fd); |
1063 | (void) fclose(hdl->libzfs_mnttab); | |
1064 | free(hdl); | |
7a6c12fd AJ |
1065 | return (NULL); |
1066 | } | |
1067 | } else { | |
1068 | hdl->libzfs_max_nvlist = (SPA_MAXBLOCKSIZE * 4); | |
1069 | } | |
d99a0153 | 1070 | |
e8bcb693 DB |
1071 | /* |
1072 | * For testing, remove some settable properties and features | |
1073 | */ | |
1074 | if (libzfs_envvar_is_set("ZFS_SYSFS_PROP_SUPPORT_TEST")) { | |
1075 | zprop_desc_t *proptbl; | |
1076 | ||
1077 | proptbl = zpool_prop_get_table(); | |
1078 | proptbl[ZPOOL_PROP_COMMENT].pd_zfs_mod_supported = B_FALSE; | |
1079 | ||
1080 | proptbl = zfs_prop_get_table(); | |
1081 | proptbl[ZFS_PROP_DNODESIZE].pd_zfs_mod_supported = B_FALSE; | |
1082 | ||
1083 | zfeature_info_t *ftbl = spa_feature_table; | |
1084 | ftbl[SPA_FEATURE_LARGE_BLOCKS].fi_zfs_mod_supported = B_FALSE; | |
1085 | } | |
1086 | ||
34dc7c2f BB |
1087 | return (hdl); |
1088 | } | |
1089 | ||
1090 | void | |
1091 | libzfs_fini(libzfs_handle_t *hdl) | |
1092 | { | |
1093 | (void) close(hdl->libzfs_fd); | |
1094 | if (hdl->libzfs_mnttab) | |
2eadf037 BB |
1095 | #ifdef HAVE_SETMNTENT |
1096 | (void) endmntent(hdl->libzfs_mnttab); | |
1097 | #else | |
34dc7c2f | 1098 | (void) fclose(hdl->libzfs_mnttab); |
2eadf037 | 1099 | #endif |
b128c09f | 1100 | zpool_free_handles(hdl); |
34dc7c2f | 1101 | namespace_clear(hdl); |
9babb374 | 1102 | libzfs_mnttab_fini(hdl); |
6f1ffb06 | 1103 | libzfs_core_fini(); |
c14ca145 | 1104 | regfree(&hdl->libzfs_urire); |
dc03fa30 | 1105 | fletcher_4_fini(); |
34dc7c2f BB |
1106 | free(hdl); |
1107 | } | |
1108 | ||
1109 | libzfs_handle_t * | |
1110 | zpool_get_handle(zpool_handle_t *zhp) | |
1111 | { | |
1112 | return (zhp->zpool_hdl); | |
1113 | } | |
1114 | ||
1115 | libzfs_handle_t * | |
1116 | zfs_get_handle(zfs_handle_t *zhp) | |
1117 | { | |
1118 | return (zhp->zfs_hdl); | |
1119 | } | |
1120 | ||
b128c09f BB |
1121 | zpool_handle_t * |
1122 | zfs_get_pool_handle(const zfs_handle_t *zhp) | |
1123 | { | |
1124 | return (zhp->zpool_hdl); | |
1125 | } | |
1126 | ||
34dc7c2f BB |
1127 | /* |
1128 | * Given a name, determine whether or not it's a valid path | |
1129 | * (starts with '/' or "./"). If so, walk the mnttab trying | |
1130 | * to match the device number. If not, treat the path as an | |
aeacdefe | 1131 | * fs/vol/snap/bkmark name. |
34dc7c2f BB |
1132 | */ |
1133 | zfs_handle_t * | |
b197457c | 1134 | zfs_path_to_zhandle(libzfs_handle_t *hdl, const char *path, zfs_type_t argtype) |
34dc7c2f BB |
1135 | { |
1136 | struct stat64 statbuf; | |
1137 | struct extmnttab entry; | |
34dc7c2f BB |
1138 | |
1139 | if (path[0] != '/' && strncmp(path, "./", strlen("./")) != 0) { | |
1140 | /* | |
1141 | * It's not a valid path, assume it's a name of type 'argtype'. | |
1142 | */ | |
1143 | return (zfs_open(hdl, path, argtype)); | |
1144 | } | |
1145 | ||
cbca6076 JL |
1146 | /* Reopen MNTTAB to prevent reading stale data from open file */ |
1147 | if (freopen(MNTTAB, "r", hdl->libzfs_mnttab) == NULL) | |
1148 | return (NULL); | |
1149 | ||
d31277ab | 1150 | if (getextmntent(path, &entry, &statbuf) != 0) |
34dc7c2f | 1151 | return (NULL); |
34dc7c2f BB |
1152 | |
1153 | if (strcmp(entry.mnt_fstype, MNTTYPE_ZFS) != 0) { | |
1154 | (void) fprintf(stderr, gettext("'%s': not a ZFS filesystem\n"), | |
1155 | path); | |
1156 | return (NULL); | |
1157 | } | |
1158 | ||
1159 | return (zfs_open(hdl, entry.mnt_special, ZFS_TYPE_FILESYSTEM)); | |
1160 | } | |
1161 | ||
1162 | /* | |
1163 | * Initialize the zc_nvlist_dst member to prepare for receiving an nvlist from | |
1164 | * an ioctl(). | |
1165 | */ | |
1166 | int | |
1167 | zcmd_alloc_dst_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, size_t len) | |
1168 | { | |
1169 | if (len == 0) | |
85ce79bb | 1170 | len = 256 * 1024; |
34dc7c2f | 1171 | zc->zc_nvlist_dst_size = len; |
23de906c CW |
1172 | zc->zc_nvlist_dst = |
1173 | (uint64_t)(uintptr_t)zfs_alloc(hdl, zc->zc_nvlist_dst_size); | |
1174 | if (zc->zc_nvlist_dst == 0) | |
34dc7c2f BB |
1175 | return (-1); |
1176 | ||
1177 | return (0); | |
1178 | } | |
1179 | ||
1180 | /* | |
1181 | * Called when an ioctl() which returns an nvlist fails with ENOMEM. This will | |
1182 | * expand the nvlist to the size specified in 'zc_nvlist_dst_size', which was | |
1183 | * filled in by the kernel to indicate the actual required size. | |
1184 | */ | |
1185 | int | |
1186 | zcmd_expand_dst_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc) | |
1187 | { | |
1188 | free((void *)(uintptr_t)zc->zc_nvlist_dst); | |
23de906c CW |
1189 | zc->zc_nvlist_dst = |
1190 | (uint64_t)(uintptr_t)zfs_alloc(hdl, zc->zc_nvlist_dst_size); | |
1191 | if (zc->zc_nvlist_dst == 0) | |
34dc7c2f BB |
1192 | return (-1); |
1193 | ||
1194 | return (0); | |
1195 | } | |
1196 | ||
1197 | /* | |
1198 | * Called to free the src and dst nvlists stored in the command structure. | |
1199 | */ | |
1200 | void | |
1201 | zcmd_free_nvlists(zfs_cmd_t *zc) | |
1202 | { | |
1203 | free((void *)(uintptr_t)zc->zc_nvlist_conf); | |
1204 | free((void *)(uintptr_t)zc->zc_nvlist_src); | |
1205 | free((void *)(uintptr_t)zc->zc_nvlist_dst); | |
23de906c CW |
1206 | zc->zc_nvlist_conf = 0; |
1207 | zc->zc_nvlist_src = 0; | |
1208 | zc->zc_nvlist_dst = 0; | |
34dc7c2f BB |
1209 | } |
1210 | ||
1211 | static int | |
1212 | zcmd_write_nvlist_com(libzfs_handle_t *hdl, uint64_t *outnv, uint64_t *outlen, | |
1213 | nvlist_t *nvl) | |
1214 | { | |
1215 | char *packed; | |
1216 | size_t len; | |
1217 | ||
1218 | verify(nvlist_size(nvl, &len, NV_ENCODE_NATIVE) == 0); | |
1219 | ||
1220 | if ((packed = zfs_alloc(hdl, len)) == NULL) | |
1221 | return (-1); | |
1222 | ||
1223 | verify(nvlist_pack(nvl, &packed, &len, NV_ENCODE_NATIVE, 0) == 0); | |
1224 | ||
1225 | *outnv = (uint64_t)(uintptr_t)packed; | |
1226 | *outlen = len; | |
1227 | ||
1228 | return (0); | |
1229 | } | |
1230 | ||
1231 | int | |
1232 | zcmd_write_conf_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, nvlist_t *nvl) | |
1233 | { | |
1234 | return (zcmd_write_nvlist_com(hdl, &zc->zc_nvlist_conf, | |
1235 | &zc->zc_nvlist_conf_size, nvl)); | |
1236 | } | |
1237 | ||
1238 | int | |
1239 | zcmd_write_src_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, nvlist_t *nvl) | |
1240 | { | |
1241 | return (zcmd_write_nvlist_com(hdl, &zc->zc_nvlist_src, | |
1242 | &zc->zc_nvlist_src_size, nvl)); | |
1243 | } | |
1244 | ||
1245 | /* | |
1246 | * Unpacks an nvlist from the ZFS ioctl command structure. | |
1247 | */ | |
1248 | int | |
1249 | zcmd_read_dst_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, nvlist_t **nvlp) | |
1250 | { | |
1251 | if (nvlist_unpack((void *)(uintptr_t)zc->zc_nvlist_dst, | |
1252 | zc->zc_nvlist_dst_size, nvlp, 0) != 0) | |
1253 | return (no_memory(hdl)); | |
1254 | ||
1255 | return (0); | |
1256 | } | |
1257 | ||
34dc7c2f BB |
1258 | /* |
1259 | * ================================================================ | |
1260 | * API shared by zfs and zpool property management | |
1261 | * ================================================================ | |
1262 | */ | |
1263 | ||
1264 | static void | |
1265 | zprop_print_headers(zprop_get_cbdata_t *cbp, zfs_type_t type) | |
1266 | { | |
1267 | zprop_list_t *pl = cbp->cb_proplist; | |
1268 | int i; | |
1269 | char *title; | |
1270 | size_t len; | |
1271 | ||
1272 | cbp->cb_first = B_FALSE; | |
1273 | if (cbp->cb_scripted) | |
1274 | return; | |
1275 | ||
1276 | /* | |
1277 | * Start with the length of the column headers. | |
1278 | */ | |
1279 | cbp->cb_colwidths[GET_COL_NAME] = strlen(dgettext(TEXT_DOMAIN, "NAME")); | |
1280 | cbp->cb_colwidths[GET_COL_PROPERTY] = strlen(dgettext(TEXT_DOMAIN, | |
1281 | "PROPERTY")); | |
1282 | cbp->cb_colwidths[GET_COL_VALUE] = strlen(dgettext(TEXT_DOMAIN, | |
1283 | "VALUE")); | |
428870ff BB |
1284 | cbp->cb_colwidths[GET_COL_RECVD] = strlen(dgettext(TEXT_DOMAIN, |
1285 | "RECEIVED")); | |
34dc7c2f BB |
1286 | cbp->cb_colwidths[GET_COL_SOURCE] = strlen(dgettext(TEXT_DOMAIN, |
1287 | "SOURCE")); | |
1288 | ||
fb5f0bc8 BB |
1289 | /* first property is always NAME */ |
1290 | assert(cbp->cb_proplist->pl_prop == | |
1291 | ((type == ZFS_TYPE_POOL) ? ZPOOL_PROP_NAME : ZFS_PROP_NAME)); | |
1292 | ||
34dc7c2f BB |
1293 | /* |
1294 | * Go through and calculate the widths for each column. For the | |
1295 | * 'source' column, we kludge it up by taking the worst-case scenario of | |
1296 | * inheriting from the longest name. This is acceptable because in the | |
1297 | * majority of cases 'SOURCE' is the last column displayed, and we don't | |
1298 | * use the width anyway. Note that the 'VALUE' column can be oversized, | |
428870ff | 1299 | * if the name of the property is much longer than any values we find. |
34dc7c2f BB |
1300 | */ |
1301 | for (pl = cbp->cb_proplist; pl != NULL; pl = pl->pl_next) { | |
1302 | /* | |
1303 | * 'PROPERTY' column | |
1304 | */ | |
1305 | if (pl->pl_prop != ZPROP_INVAL) { | |
1306 | const char *propname = (type == ZFS_TYPE_POOL) ? | |
1307 | zpool_prop_to_name(pl->pl_prop) : | |
1308 | zfs_prop_to_name(pl->pl_prop); | |
1309 | ||
1310 | len = strlen(propname); | |
1311 | if (len > cbp->cb_colwidths[GET_COL_PROPERTY]) | |
1312 | cbp->cb_colwidths[GET_COL_PROPERTY] = len; | |
1313 | } else { | |
1314 | len = strlen(pl->pl_user_prop); | |
1315 | if (len > cbp->cb_colwidths[GET_COL_PROPERTY]) | |
1316 | cbp->cb_colwidths[GET_COL_PROPERTY] = len; | |
1317 | } | |
1318 | ||
1319 | /* | |
fb5f0bc8 BB |
1320 | * 'VALUE' column. The first property is always the 'name' |
1321 | * property that was tacked on either by /sbin/zfs's | |
1322 | * zfs_do_get() or when calling zprop_expand_list(), so we | |
1323 | * ignore its width. If the user specified the name property | |
1324 | * to display, then it will be later in the list in any case. | |
34dc7c2f | 1325 | */ |
fb5f0bc8 | 1326 | if (pl != cbp->cb_proplist && |
34dc7c2f BB |
1327 | pl->pl_width > cbp->cb_colwidths[GET_COL_VALUE]) |
1328 | cbp->cb_colwidths[GET_COL_VALUE] = pl->pl_width; | |
1329 | ||
428870ff BB |
1330 | /* 'RECEIVED' column. */ |
1331 | if (pl != cbp->cb_proplist && | |
1332 | pl->pl_recvd_width > cbp->cb_colwidths[GET_COL_RECVD]) | |
1333 | cbp->cb_colwidths[GET_COL_RECVD] = pl->pl_recvd_width; | |
1334 | ||
34dc7c2f BB |
1335 | /* |
1336 | * 'NAME' and 'SOURCE' columns | |
1337 | */ | |
1338 | if (pl->pl_prop == (type == ZFS_TYPE_POOL ? ZPOOL_PROP_NAME : | |
1339 | ZFS_PROP_NAME) && | |
1340 | pl->pl_width > cbp->cb_colwidths[GET_COL_NAME]) { | |
1341 | cbp->cb_colwidths[GET_COL_NAME] = pl->pl_width; | |
1342 | cbp->cb_colwidths[GET_COL_SOURCE] = pl->pl_width + | |
1343 | strlen(dgettext(TEXT_DOMAIN, "inherited from")); | |
1344 | } | |
1345 | } | |
1346 | ||
1347 | /* | |
1348 | * Now go through and print the headers. | |
1349 | */ | |
428870ff | 1350 | for (i = 0; i < ZFS_GET_NCOLS; i++) { |
34dc7c2f BB |
1351 | switch (cbp->cb_columns[i]) { |
1352 | case GET_COL_NAME: | |
1353 | title = dgettext(TEXT_DOMAIN, "NAME"); | |
1354 | break; | |
1355 | case GET_COL_PROPERTY: | |
1356 | title = dgettext(TEXT_DOMAIN, "PROPERTY"); | |
1357 | break; | |
1358 | case GET_COL_VALUE: | |
1359 | title = dgettext(TEXT_DOMAIN, "VALUE"); | |
1360 | break; | |
428870ff BB |
1361 | case GET_COL_RECVD: |
1362 | title = dgettext(TEXT_DOMAIN, "RECEIVED"); | |
1363 | break; | |
34dc7c2f BB |
1364 | case GET_COL_SOURCE: |
1365 | title = dgettext(TEXT_DOMAIN, "SOURCE"); | |
1366 | break; | |
1367 | default: | |
1368 | title = NULL; | |
1369 | } | |
1370 | ||
1371 | if (title != NULL) { | |
428870ff BB |
1372 | if (i == (ZFS_GET_NCOLS - 1) || |
1373 | cbp->cb_columns[i + 1] == GET_COL_NONE) | |
34dc7c2f BB |
1374 | (void) printf("%s", title); |
1375 | else | |
1376 | (void) printf("%-*s ", | |
1377 | cbp->cb_colwidths[cbp->cb_columns[i]], | |
1378 | title); | |
1379 | } | |
1380 | } | |
1381 | (void) printf("\n"); | |
1382 | } | |
1383 | ||
1384 | /* | |
1385 | * Display a single line of output, according to the settings in the callback | |
1386 | * structure. | |
1387 | */ | |
1388 | void | |
1389 | zprop_print_one_property(const char *name, zprop_get_cbdata_t *cbp, | |
1390 | const char *propname, const char *value, zprop_source_t sourcetype, | |
428870ff | 1391 | const char *source, const char *recvd_value) |
34dc7c2f BB |
1392 | { |
1393 | int i; | |
d4ed6673 | 1394 | const char *str = NULL; |
34dc7c2f BB |
1395 | char buf[128]; |
1396 | ||
1397 | /* | |
1398 | * Ignore those source types that the user has chosen to ignore. | |
1399 | */ | |
1400 | if ((sourcetype & cbp->cb_sources) == 0) | |
1401 | return; | |
1402 | ||
1403 | if (cbp->cb_first) | |
1404 | zprop_print_headers(cbp, cbp->cb_type); | |
1405 | ||
428870ff | 1406 | for (i = 0; i < ZFS_GET_NCOLS; i++) { |
34dc7c2f BB |
1407 | switch (cbp->cb_columns[i]) { |
1408 | case GET_COL_NAME: | |
1409 | str = name; | |
1410 | break; | |
1411 | ||
1412 | case GET_COL_PROPERTY: | |
1413 | str = propname; | |
1414 | break; | |
1415 | ||
1416 | case GET_COL_VALUE: | |
1417 | str = value; | |
1418 | break; | |
1419 | ||
1420 | case GET_COL_SOURCE: | |
1421 | switch (sourcetype) { | |
1422 | case ZPROP_SRC_NONE: | |
1423 | str = "-"; | |
1424 | break; | |
1425 | ||
1426 | case ZPROP_SRC_DEFAULT: | |
1427 | str = "default"; | |
1428 | break; | |
1429 | ||
1430 | case ZPROP_SRC_LOCAL: | |
1431 | str = "local"; | |
1432 | break; | |
1433 | ||
1434 | case ZPROP_SRC_TEMPORARY: | |
1435 | str = "temporary"; | |
1436 | break; | |
1437 | ||
1438 | case ZPROP_SRC_INHERITED: | |
1439 | (void) snprintf(buf, sizeof (buf), | |
1440 | "inherited from %s", source); | |
1441 | str = buf; | |
1442 | break; | |
428870ff BB |
1443 | case ZPROP_SRC_RECEIVED: |
1444 | str = "received"; | |
1445 | break; | |
23d70cde GM |
1446 | |
1447 | default: | |
1448 | str = NULL; | |
1449 | assert(!"unhandled zprop_source_t"); | |
34dc7c2f BB |
1450 | } |
1451 | break; | |
1452 | ||
428870ff BB |
1453 | case GET_COL_RECVD: |
1454 | str = (recvd_value == NULL ? "-" : recvd_value); | |
1455 | break; | |
1456 | ||
34dc7c2f BB |
1457 | default: |
1458 | continue; | |
1459 | } | |
1460 | ||
23827a4c G |
1461 | if (i == (ZFS_GET_NCOLS - 1) || |
1462 | cbp->cb_columns[i + 1] == GET_COL_NONE) | |
34dc7c2f BB |
1463 | (void) printf("%s", str); |
1464 | else if (cbp->cb_scripted) | |
1465 | (void) printf("%s\t", str); | |
1466 | else | |
1467 | (void) printf("%-*s ", | |
1468 | cbp->cb_colwidths[cbp->cb_columns[i]], | |
1469 | str); | |
34dc7c2f BB |
1470 | } |
1471 | ||
1472 | (void) printf("\n"); | |
1473 | } | |
1474 | ||
1475 | /* | |
1476 | * Given a numeric suffix, convert the value into a number of bits that the | |
1477 | * resulting value must be shifted. | |
1478 | */ | |
1479 | static int | |
1480 | str2shift(libzfs_handle_t *hdl, const char *buf) | |
1481 | { | |
1482 | const char *ends = "BKMGTPEZ"; | |
1483 | int i; | |
1484 | ||
1485 | if (buf[0] == '\0') | |
1486 | return (0); | |
1487 | for (i = 0; i < strlen(ends); i++) { | |
1488 | if (toupper(buf[0]) == ends[i]) | |
1489 | break; | |
1490 | } | |
1491 | if (i == strlen(ends)) { | |
53c2ec1d JL |
1492 | if (hdl) |
1493 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1494 | "invalid numeric suffix '%s'"), buf); | |
34dc7c2f BB |
1495 | return (-1); |
1496 | } | |
1497 | ||
1498 | /* | |
826ab7ad RL |
1499 | * Allow 'G' = 'GB' = 'GiB', case-insensitively. |
1500 | * However, 'BB' and 'BiB' are disallowed. | |
34dc7c2f | 1501 | */ |
826ab7ad RL |
1502 | if (buf[1] == '\0' || |
1503 | (toupper(buf[0]) != 'B' && | |
d1d7e268 MK |
1504 | ((toupper(buf[1]) == 'B' && buf[2] == '\0') || |
1505 | (toupper(buf[1]) == 'I' && toupper(buf[2]) == 'B' && | |
1506 | buf[3] == '\0')))) | |
1507 | return (10 * i); | |
34dc7c2f | 1508 | |
53c2ec1d JL |
1509 | if (hdl) |
1510 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1511 | "invalid numeric suffix '%s'"), buf); | |
34dc7c2f BB |
1512 | return (-1); |
1513 | } | |
1514 | ||
1515 | /* | |
1516 | * Convert a string of the form '100G' into a real number. Used when setting | |
1517 | * properties or creating a volume. 'buf' is used to place an extended error | |
1518 | * message for the caller to use. | |
1519 | */ | |
1520 | int | |
1521 | zfs_nicestrtonum(libzfs_handle_t *hdl, const char *value, uint64_t *num) | |
1522 | { | |
1523 | char *end; | |
1524 | int shift; | |
1525 | ||
1526 | *num = 0; | |
1527 | ||
1528 | /* Check to see if this looks like a number. */ | |
1529 | if ((value[0] < '0' || value[0] > '9') && value[0] != '.') { | |
1530 | if (hdl) | |
1531 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1532 | "bad numeric value '%s'"), value); | |
1533 | return (-1); | |
1534 | } | |
1535 | ||
428870ff | 1536 | /* Rely on strtoull() to process the numeric portion. */ |
34dc7c2f | 1537 | errno = 0; |
d164b209 | 1538 | *num = strtoull(value, &end, 10); |
34dc7c2f BB |
1539 | |
1540 | /* | |
1541 | * Check for ERANGE, which indicates that the value is too large to fit | |
1542 | * in a 64-bit value. | |
1543 | */ | |
1544 | if (errno == ERANGE) { | |
1545 | if (hdl) | |
1546 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1547 | "numeric value is too large")); | |
1548 | return (-1); | |
1549 | } | |
1550 | ||
1551 | /* | |
1552 | * If we have a decimal value, then do the computation with floating | |
1553 | * point arithmetic. Otherwise, use standard arithmetic. | |
1554 | */ | |
1555 | if (*end == '.') { | |
1556 | double fval = strtod(value, &end); | |
1557 | ||
1558 | if ((shift = str2shift(hdl, end)) == -1) | |
1559 | return (-1); | |
1560 | ||
1561 | fval *= pow(2, shift); | |
1562 | ||
4d32abaa RM |
1563 | /* |
1564 | * UINT64_MAX is not exactly representable as a double. | |
1565 | * The closest representation is UINT64_MAX + 1, so we | |
1566 | * use a >= comparison instead of > for the bounds check. | |
1567 | */ | |
1568 | if (fval >= (double)UINT64_MAX) { | |
34dc7c2f BB |
1569 | if (hdl) |
1570 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1571 | "numeric value is too large")); | |
1572 | return (-1); | |
1573 | } | |
1574 | ||
1575 | *num = (uint64_t)fval; | |
1576 | } else { | |
1577 | if ((shift = str2shift(hdl, end)) == -1) | |
1578 | return (-1); | |
1579 | ||
1580 | /* Check for overflow */ | |
1581 | if (shift >= 64 || (*num << shift) >> shift != *num) { | |
1582 | if (hdl) | |
1583 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1584 | "numeric value is too large")); | |
1585 | return (-1); | |
1586 | } | |
1587 | ||
1588 | *num <<= shift; | |
1589 | } | |
1590 | ||
1591 | return (0); | |
1592 | } | |
1593 | ||
1594 | /* | |
1595 | * Given a propname=value nvpair to set, parse any numeric properties | |
1596 | * (index, boolean, etc) if they are specified as strings and add the | |
1597 | * resulting nvpair to the returned nvlist. | |
1598 | * | |
1599 | * At the DSL layer, all properties are either 64-bit numbers or strings. | |
1600 | * We want the user to be able to ignore this fact and specify properties | |
1601 | * as native values (numbers, for example) or as strings (to simplify | |
1602 | * command line utilities). This also handles converting index types | |
1603 | * (compression, checksum, etc) from strings to their on-disk index. | |
1604 | */ | |
1605 | int | |
1606 | zprop_parse_value(libzfs_handle_t *hdl, nvpair_t *elem, int prop, | |
1607 | zfs_type_t type, nvlist_t *ret, char **svalp, uint64_t *ivalp, | |
1608 | const char *errbuf) | |
1609 | { | |
1610 | data_type_t datatype = nvpair_type(elem); | |
1611 | zprop_type_t proptype; | |
1612 | const char *propname; | |
1613 | char *value; | |
1614 | boolean_t isnone = B_FALSE; | |
d22f3a82 | 1615 | boolean_t isauto = B_FALSE; |
b6ca6193 | 1616 | int err = 0; |
34dc7c2f BB |
1617 | |
1618 | if (type == ZFS_TYPE_POOL) { | |
1619 | proptype = zpool_prop_get_type(prop); | |
1620 | propname = zpool_prop_to_name(prop); | |
1621 | } else { | |
1622 | proptype = zfs_prop_get_type(prop); | |
1623 | propname = zfs_prop_to_name(prop); | |
1624 | } | |
1625 | ||
1626 | /* | |
1627 | * Convert any properties to the internal DSL value types. | |
1628 | */ | |
1629 | *svalp = NULL; | |
1630 | *ivalp = 0; | |
1631 | ||
1632 | switch (proptype) { | |
1633 | case PROP_TYPE_STRING: | |
1634 | if (datatype != DATA_TYPE_STRING) { | |
1635 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1636 | "'%s' must be a string"), nvpair_name(elem)); | |
1637 | goto error; | |
1638 | } | |
b6ca6193 | 1639 | err = nvpair_value_string(elem, svalp); |
1640 | if (err != 0) { | |
1641 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1642 | "'%s' is invalid"), nvpair_name(elem)); | |
1643 | goto error; | |
1644 | } | |
34dc7c2f BB |
1645 | if (strlen(*svalp) >= ZFS_MAXPROPLEN) { |
1646 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1647 | "'%s' is too long"), nvpair_name(elem)); | |
1648 | goto error; | |
1649 | } | |
1650 | break; | |
1651 | ||
1652 | case PROP_TYPE_NUMBER: | |
1653 | if (datatype == DATA_TYPE_STRING) { | |
1654 | (void) nvpair_value_string(elem, &value); | |
1655 | if (strcmp(value, "none") == 0) { | |
1656 | isnone = B_TRUE; | |
d22f3a82 MG |
1657 | } else if (strcmp(value, "auto") == 0) { |
1658 | isauto = B_TRUE; | |
1659 | } else if (zfs_nicestrtonum(hdl, value, ivalp) != 0) { | |
34dc7c2f BB |
1660 | goto error; |
1661 | } | |
1662 | } else if (datatype == DATA_TYPE_UINT64) { | |
1663 | (void) nvpair_value_uint64(elem, ivalp); | |
1664 | } else { | |
1665 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1666 | "'%s' must be a number"), nvpair_name(elem)); | |
1667 | goto error; | |
1668 | } | |
1669 | ||
1670 | /* | |
1671 | * Quota special: force 'none' and don't allow 0. | |
1672 | */ | |
1673 | if ((type & ZFS_TYPE_DATASET) && *ivalp == 0 && !isnone && | |
1674 | (prop == ZFS_PROP_QUOTA || prop == ZFS_PROP_REFQUOTA)) { | |
1675 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1676 | "use 'none' to disable quota/refquota")); | |
1677 | goto error; | |
1678 | } | |
788eb90c JJ |
1679 | |
1680 | /* | |
1681 | * Special handling for "*_limit=none". In this case it's not | |
1682 | * 0 but UINT64_MAX. | |
1683 | */ | |
1684 | if ((type & ZFS_TYPE_DATASET) && isnone && | |
1685 | (prop == ZFS_PROP_FILESYSTEM_LIMIT || | |
1686 | prop == ZFS_PROP_SNAPSHOT_LIMIT)) { | |
1687 | *ivalp = UINT64_MAX; | |
1688 | } | |
d22f3a82 MG |
1689 | |
1690 | /* | |
1691 | * Special handling for setting 'refreservation' to 'auto'. Use | |
1692 | * UINT64_MAX to tell the caller to use zfs_fix_auto_resv(). | |
1693 | * 'auto' is only allowed on volumes. | |
1694 | */ | |
1695 | if (isauto) { | |
1696 | switch (prop) { | |
1697 | case ZFS_PROP_REFRESERVATION: | |
1698 | if ((type & ZFS_TYPE_VOLUME) == 0) { | |
1699 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1700 | "'%s=auto' only allowed on " | |
1701 | "volumes"), nvpair_name(elem)); | |
1702 | goto error; | |
1703 | } | |
1704 | *ivalp = UINT64_MAX; | |
1705 | break; | |
1706 | default: | |
1707 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1708 | "'auto' is invalid value for '%s'"), | |
1709 | nvpair_name(elem)); | |
1710 | goto error; | |
1711 | } | |
1712 | } | |
1713 | ||
34dc7c2f BB |
1714 | break; |
1715 | ||
1716 | case PROP_TYPE_INDEX: | |
1717 | if (datatype != DATA_TYPE_STRING) { | |
1718 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1719 | "'%s' must be a string"), nvpair_name(elem)); | |
1720 | goto error; | |
1721 | } | |
1722 | ||
1723 | (void) nvpair_value_string(elem, &value); | |
1724 | ||
1725 | if (zprop_string_to_index(prop, value, ivalp, type) != 0) { | |
1726 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1727 | "'%s' must be one of '%s'"), propname, | |
1728 | zprop_values(prop, type)); | |
1729 | goto error; | |
1730 | } | |
1731 | break; | |
1732 | ||
1733 | default: | |
1734 | abort(); | |
1735 | } | |
1736 | ||
1737 | /* | |
1738 | * Add the result to our return set of properties. | |
1739 | */ | |
1740 | if (*svalp != NULL) { | |
1741 | if (nvlist_add_string(ret, propname, *svalp) != 0) { | |
1742 | (void) no_memory(hdl); | |
1743 | return (-1); | |
1744 | } | |
1745 | } else { | |
1746 | if (nvlist_add_uint64(ret, propname, *ivalp) != 0) { | |
1747 | (void) no_memory(hdl); | |
1748 | return (-1); | |
1749 | } | |
1750 | } | |
1751 | ||
1752 | return (0); | |
1753 | error: | |
1754 | (void) zfs_error(hdl, EZFS_BADPROP, errbuf); | |
1755 | return (-1); | |
1756 | } | |
1757 | ||
b128c09f BB |
1758 | static int |
1759 | addlist(libzfs_handle_t *hdl, char *propname, zprop_list_t **listp, | |
1760 | zfs_type_t type) | |
1761 | { | |
1762 | int prop; | |
1763 | zprop_list_t *entry; | |
1764 | ||
1765 | prop = zprop_name_to_prop(propname, type); | |
1766 | ||
962d5242 | 1767 | if (prop != ZPROP_INVAL && !zprop_valid_for_type(prop, type, B_FALSE)) |
b128c09f BB |
1768 | prop = ZPROP_INVAL; |
1769 | ||
1770 | /* | |
1771 | * When no property table entry can be found, return failure if | |
1772 | * this is a pool property or if this isn't a user-defined | |
1773 | * dataset property, | |
1774 | */ | |
9ae529ec CS |
1775 | if (prop == ZPROP_INVAL && ((type == ZFS_TYPE_POOL && |
1776 | !zpool_prop_feature(propname) && | |
1777 | !zpool_prop_unsupported(propname)) || | |
1778 | (type == ZFS_TYPE_DATASET && !zfs_prop_user(propname) && | |
1779 | !zfs_prop_userquota(propname) && !zfs_prop_written(propname)))) { | |
b128c09f BB |
1780 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, |
1781 | "invalid property '%s'"), propname); | |
1782 | return (zfs_error(hdl, EZFS_BADPROP, | |
1783 | dgettext(TEXT_DOMAIN, "bad property list"))); | |
1784 | } | |
1785 | ||
1786 | if ((entry = zfs_alloc(hdl, sizeof (zprop_list_t))) == NULL) | |
1787 | return (-1); | |
1788 | ||
1789 | entry->pl_prop = prop; | |
1790 | if (prop == ZPROP_INVAL) { | |
9ae529ec CS |
1791 | if ((entry->pl_user_prop = zfs_strdup(hdl, propname)) == |
1792 | NULL) { | |
b128c09f BB |
1793 | free(entry); |
1794 | return (-1); | |
1795 | } | |
1796 | entry->pl_width = strlen(propname); | |
1797 | } else { | |
1798 | entry->pl_width = zprop_width(prop, &entry->pl_fixed, | |
1799 | type); | |
1800 | } | |
1801 | ||
1802 | *listp = entry; | |
1803 | ||
1804 | return (0); | |
1805 | } | |
1806 | ||
34dc7c2f BB |
1807 | /* |
1808 | * Given a comma-separated list of properties, construct a property list | |
1809 | * containing both user-defined and native properties. This function will | |
1810 | * return a NULL list if 'all' is specified, which can later be expanded | |
1811 | * by zprop_expand_list(). | |
1812 | */ | |
1813 | int | |
1814 | zprop_get_list(libzfs_handle_t *hdl, char *props, zprop_list_t **listp, | |
1815 | zfs_type_t type) | |
1816 | { | |
34dc7c2f | 1817 | *listp = NULL; |
34dc7c2f BB |
1818 | |
1819 | /* | |
1820 | * If 'all' is specified, return a NULL list. | |
1821 | */ | |
1822 | if (strcmp(props, "all") == 0) | |
1823 | return (0); | |
1824 | ||
1825 | /* | |
1826 | * If no props were specified, return an error. | |
1827 | */ | |
1828 | if (props[0] == '\0') { | |
1829 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1830 | "no properties specified")); | |
1831 | return (zfs_error(hdl, EZFS_BADPROP, dgettext(TEXT_DOMAIN, | |
1832 | "bad property list"))); | |
1833 | } | |
1834 | ||
1835 | /* | |
1836 | * It would be nice to use getsubopt() here, but the inclusion of column | |
1837 | * aliases makes this more effort than it's worth. | |
1838 | */ | |
b128c09f BB |
1839 | while (*props != '\0') { |
1840 | size_t len; | |
1841 | char *p; | |
1842 | char c; | |
1843 | ||
1844 | if ((p = strchr(props, ',')) == NULL) { | |
1845 | len = strlen(props); | |
1846 | p = props + len; | |
34dc7c2f | 1847 | } else { |
b128c09f | 1848 | len = p - props; |
34dc7c2f BB |
1849 | } |
1850 | ||
1851 | /* | |
1852 | * Check for empty options. | |
1853 | */ | |
1854 | if (len == 0) { | |
1855 | zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, | |
1856 | "empty property name")); | |
1857 | return (zfs_error(hdl, EZFS_BADPROP, | |
1858 | dgettext(TEXT_DOMAIN, "bad property list"))); | |
1859 | } | |
1860 | ||
1861 | /* | |
1862 | * Check all regular property names. | |
1863 | */ | |
b128c09f BB |
1864 | c = props[len]; |
1865 | props[len] = '\0'; | |
1866 | ||
1867 | if (strcmp(props, "space") == 0) { | |
1868 | static char *spaceprops[] = { | |
1869 | "name", "avail", "used", "usedbysnapshots", | |
1870 | "usedbydataset", "usedbyrefreservation", | |
1871 | "usedbychildren", NULL | |
1872 | }; | |
1873 | int i; | |
1874 | ||
1875 | for (i = 0; spaceprops[i]; i++) { | |
1876 | if (addlist(hdl, spaceprops[i], listp, type)) | |
1877 | return (-1); | |
1878 | listp = &(*listp)->pl_next; | |
34dc7c2f | 1879 | } |
34dc7c2f | 1880 | } else { |
b128c09f BB |
1881 | if (addlist(hdl, props, listp, type)) |
1882 | return (-1); | |
1883 | listp = &(*listp)->pl_next; | |
34dc7c2f BB |
1884 | } |
1885 | ||
b128c09f | 1886 | props = p; |
34dc7c2f | 1887 | if (c == ',') |
b128c09f | 1888 | props++; |
34dc7c2f BB |
1889 | } |
1890 | ||
1891 | return (0); | |
1892 | } | |
1893 | ||
1894 | void | |
1895 | zprop_free_list(zprop_list_t *pl) | |
1896 | { | |
1897 | zprop_list_t *next; | |
1898 | ||
1899 | while (pl != NULL) { | |
1900 | next = pl->pl_next; | |
1901 | free(pl->pl_user_prop); | |
1902 | free(pl); | |
1903 | pl = next; | |
1904 | } | |
1905 | } | |
1906 | ||
1907 | typedef struct expand_data { | |
1908 | zprop_list_t **last; | |
1909 | libzfs_handle_t *hdl; | |
1910 | zfs_type_t type; | |
1911 | } expand_data_t; | |
1912 | ||
65c7cc49 | 1913 | static int |
34dc7c2f BB |
1914 | zprop_expand_list_cb(int prop, void *cb) |
1915 | { | |
1916 | zprop_list_t *entry; | |
1917 | expand_data_t *edp = cb; | |
1918 | ||
1919 | if ((entry = zfs_alloc(edp->hdl, sizeof (zprop_list_t))) == NULL) | |
1920 | return (ZPROP_INVAL); | |
1921 | ||
1922 | entry->pl_prop = prop; | |
1923 | entry->pl_width = zprop_width(prop, &entry->pl_fixed, edp->type); | |
1924 | entry->pl_all = B_TRUE; | |
1925 | ||
1926 | *(edp->last) = entry; | |
1927 | edp->last = &entry->pl_next; | |
1928 | ||
1929 | return (ZPROP_CONT); | |
1930 | } | |
1931 | ||
1932 | int | |
1933 | zprop_expand_list(libzfs_handle_t *hdl, zprop_list_t **plp, zfs_type_t type) | |
1934 | { | |
1935 | zprop_list_t *entry; | |
1936 | zprop_list_t **last; | |
1937 | expand_data_t exp; | |
1938 | ||
1939 | if (*plp == NULL) { | |
1940 | /* | |
1941 | * If this is the very first time we've been called for an 'all' | |
1942 | * specification, expand the list to include all native | |
1943 | * properties. | |
1944 | */ | |
1945 | last = plp; | |
1946 | ||
1947 | exp.last = last; | |
1948 | exp.hdl = hdl; | |
1949 | exp.type = type; | |
1950 | ||
1951 | if (zprop_iter_common(zprop_expand_list_cb, &exp, B_FALSE, | |
1952 | B_FALSE, type) == ZPROP_INVAL) | |
1953 | return (-1); | |
1954 | ||
1955 | /* | |
1956 | * Add 'name' to the beginning of the list, which is handled | |
1957 | * specially. | |
1958 | */ | |
1959 | if ((entry = zfs_alloc(hdl, sizeof (zprop_list_t))) == NULL) | |
1960 | return (-1); | |
1961 | ||
1962 | entry->pl_prop = (type == ZFS_TYPE_POOL) ? ZPOOL_PROP_NAME : | |
1963 | ZFS_PROP_NAME; | |
1964 | entry->pl_width = zprop_width(entry->pl_prop, | |
1965 | &entry->pl_fixed, type); | |
1966 | entry->pl_all = B_TRUE; | |
1967 | entry->pl_next = *plp; | |
1968 | *plp = entry; | |
1969 | } | |
1970 | return (0); | |
1971 | } | |
1972 | ||
1973 | int | |
1974 | zprop_iter(zprop_func func, void *cb, boolean_t show_all, boolean_t ordered, | |
1975 | zfs_type_t type) | |
1976 | { | |
1977 | return (zprop_iter_common(func, cb, show_all, ordered, type)); | |
1978 | } | |
50478c6d T |
1979 | |
1980 | /* | |
1981 | * Fill given version buffer with zfs userland version | |
1982 | */ | |
1983 | void | |
1984 | zfs_version_userland(char *version, int len) | |
1985 | { | |
1986 | (void) strlcpy(version, ZFS_META_ALIAS, len); | |
1987 | } | |
1988 | ||
50478c6d T |
1989 | /* |
1990 | * Prints both zfs userland and kernel versions | |
1991 | * Returns 0 on success, and -1 on error (with errno set) | |
1992 | */ | |
1993 | int | |
1994 | zfs_version_print(void) | |
1995 | { | |
1996 | char zver_userland[128]; | |
1997 | char zver_kernel[128]; | |
1998 | ||
2451a553 I |
1999 | zfs_version_userland(zver_userland, sizeof (zver_userland)); |
2000 | ||
2001 | (void) printf("%s\n", zver_userland); | |
2002 | ||
50478c6d T |
2003 | if (zfs_version_kernel(zver_kernel, sizeof (zver_kernel)) == -1) { |
2004 | fprintf(stderr, "zfs_version_kernel() failed: %s\n", | |
2005 | strerror(errno)); | |
2006 | return (-1); | |
2007 | } | |
2008 | ||
50478c6d T |
2009 | (void) printf("zfs-kmod-%s\n", zver_kernel); |
2010 | ||
2011 | return (0); | |
2012 | } | |
9fb2771a TH |
2013 | |
2014 | /* | |
2015 | * Return 1 if the user requested ANSI color output, and our terminal supports | |
2016 | * it. Return 0 for no color. | |
2017 | */ | |
2018 | static int | |
2019 | use_color(void) | |
2020 | { | |
2021 | static int use_color = -1; | |
2022 | char *term; | |
2023 | ||
2024 | /* | |
2025 | * Optimization: | |
2026 | * | |
2027 | * For each zpool invocation, we do a single check to see if we should | |
2028 | * be using color or not, and cache that value for the lifetime of the | |
2029 | * the zpool command. That makes it cheap to call use_color() when | |
2030 | * we're printing with color. We assume that the settings are not going | |
2031 | * to change during the invocation of a zpool command (the user isn't | |
2032 | * going to change the ZFS_COLOR value while zpool is running, for | |
2033 | * example). | |
2034 | */ | |
2035 | if (use_color != -1) { | |
2036 | /* | |
2037 | * We've already figured out if we should be using color or | |
2038 | * not. Return the cached value. | |
2039 | */ | |
2040 | return (use_color); | |
2041 | } | |
2042 | ||
2043 | term = getenv("TERM"); | |
2044 | /* | |
2045 | * The user sets the ZFS_COLOR env var set to enable zpool ANSI color | |
2046 | * output. However if NO_COLOR is set (https://no-color.org/) then | |
2047 | * don't use it. Also, don't use color if terminal doesn't support | |
2048 | * it. | |
2049 | */ | |
2050 | if (libzfs_envvar_is_set("ZFS_COLOR") && | |
2051 | !libzfs_envvar_is_set("NO_COLOR") && | |
2052 | isatty(STDOUT_FILENO) && term && strcmp("dumb", term) != 0 && | |
2053 | strcmp("unknown", term) != 0) { | |
2054 | /* Color supported */ | |
2055 | use_color = 1; | |
2056 | } else { | |
2057 | use_color = 0; | |
2058 | } | |
2059 | ||
2060 | return (use_color); | |
2061 | } | |
2062 | ||
2063 | /* | |
2064 | * color_start() and color_end() are used for when you want to colorize a block | |
2065 | * of text. For example: | |
2066 | * | |
2067 | * color_start(ANSI_RED_FG) | |
2068 | * printf("hello"); | |
2069 | * printf("world"); | |
2070 | * color_end(); | |
2071 | */ | |
2072 | void | |
2073 | color_start(char *color) | |
2074 | { | |
2075 | if (use_color()) | |
2076 | printf("%s", color); | |
2077 | } | |
2078 | ||
2079 | void | |
2080 | color_end(void) | |
2081 | { | |
2082 | if (use_color()) | |
2083 | printf(ANSI_RESET); | |
2084 | } | |
2085 | ||
2086 | /* printf() with a color. If color is NULL, then do a normal printf. */ | |
2087 | int | |
2088 | printf_color(char *color, char *format, ...) | |
2089 | { | |
2090 | va_list aptr; | |
2091 | int rc; | |
2092 | ||
2093 | if (color) | |
2094 | color_start(color); | |
2095 | ||
2096 | va_start(aptr, format); | |
2097 | rc = vprintf(format, aptr); | |
2098 | va_end(aptr); | |
2099 | ||
2100 | if (color) | |
2101 | color_end(); | |
2102 | ||
2103 | return (rc); | |
2104 | } |