lib/libbe/be_error.c

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause
   3  *
   4  * Copyright (c) 2017 Kyle J. Kneitinger <kyle@kneit.in>
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  25  * SUCH DAMAGE.
  26  */
  27
  28 #include <sys/cdefs.h>
  29 #include "be.h"
  30 #include "be_impl.h"
  31
  32 /*
  33  * Usage
  34  */
  35 int
  36 libbe_errno(libbe_handle_t *lbh)
  37 {
  38
  39         return (lbh->error);
  40 }
  41
  42
  43 const char *
  44 libbe_error_description(libbe_handle_t *lbh)
  45 {
  46
  47         switch (lbh->error) {
  48         case BE_ERR_INVALIDNAME:
  49                 return ("invalid boot environment name");
  50
  51         case BE_ERR_EXISTS:
  52                 return ("boot environment name already taken");
  53
  54         case BE_ERR_NOENT:
  55                 return ("specified boot environment does not exist");
  56
  57         case BE_ERR_PERMS:
  58                 return ("insufficient permissions");
  59
  60         case BE_ERR_DESTROYACT:
  61                 return ("cannot destroy active boot environment");
  62
  63         case BE_ERR_DESTROYMNT:
  64                 return ("cannot destroy mounted boot env unless forced");
  65
  66         case BE_ERR_BADPATH:
  67                 return ("path not suitable for operation");
  68
  69         case BE_ERR_PATHBUSY:
  70                 return ("specified path is busy");
  71
  72         case BE_ERR_PATHLEN:
  73                 return ("provided path name exceeds maximum length limit");
  74
  75         case BE_ERR_BADMOUNT:
  76                 return ("mountpoint is not \"/\"");
  77
  78         case BE_ERR_NOORIGIN:
  79                 return ("could not open snapshot's origin");
  80
  81         case BE_ERR_MOUNTED:
  82                 return ("boot environment is already mounted");
  83
  84         case BE_ERR_NOMOUNT:
  85                 return ("boot environment is not mounted");
  86
  87         case BE_ERR_ZFSOPEN:
  88                 return ("calling zfs_open() failed");
  89
  90         case BE_ERR_ZFSCLONE:
  91                 return ("error when calling zfs_clone() to create boot env");
  92
  93         case BE_ERR_IO:
  94                 return ("input/output error");
  95
  96         case BE_ERR_NOPOOL:
  97                 return ("operation not supported on this pool");
  98
  99         case BE_ERR_NOMEM:
 100                 return ("insufficient memory");
 101
 102         case BE_ERR_UNKNOWN:
 103                 return ("unknown error");
 104
 105         case BE_ERR_INVORIGIN:
 106                 return ("invalid origin");
 107
 108         case BE_ERR_HASCLONES:
 109                 return ("snapshot has clones");
 110
 111         default:
 112                 assert(lbh->error == BE_ERR_SUCCESS);
 113                 return ("no error");
 114         }
 115 }
 116
 117
 118 void
 119 libbe_print_on_error(libbe_handle_t *lbh, bool val)
 120 {
 121
 122         lbh->print_on_err = val;
 123         libzfs_print_on_error(lbh->lzh, val);
 124 }
 125
 126
 127 int
 128 set_error(libbe_handle_t *lbh, be_error_t err)
 129 {
 130
 131         lbh->error = err;
 132         if (lbh->print_on_err && (err != BE_ERR_SUCCESS))
 133                 fprintf(stderr, "%s\n", libbe_error_description(lbh));
 134
 135         return (err);
 136 }