Changeset View
Changeset View
Standalone View
Standalone View
lib/libbe/libbe.3
Show All 22 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd November 21, 2018 | .Dd January 28, 2019 | ||||
.Dt LIBBE 3 | .Dt LIBBE 3 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm libbe | .Nm libbe | ||||
.Nd library for creating, destroying and modifying ZFS boot environments | .Nd library for creating, destroying and modifying ZFS boot environments | ||||
.Sh LIBRARY | .Sh LIBRARY | ||||
.Lb libbe | .Lb libbe | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
Show All 27 Lines | |||||
.Pp | .Pp | ||||
.Ft int | .Ft int | ||||
.Fn be_create_from_existing_snap "libbe_handle_t *hdl" "const char *be_name" "const char *snap" | .Fn be_create_from_existing_snap "libbe_handle_t *hdl" "const char *be_name" "const char *snap" | ||||
.Pp | .Pp | ||||
.Ft int | .Ft int | ||||
.Fn be_rename "libbe_handle_t *hdl" "const char *be_old" "const char *be_new" | .Fn be_rename "libbe_handle_t *hdl" "const char *be_old" "const char *be_new" | ||||
.Pp | .Pp | ||||
.Ft int | .Ft int | ||||
.Fn be_nextboot_options "libbe_handle_t *hdl" "const char *options" | |||||
.Ft int | |||||
.Fn be_activate "libbe_handle_t *hdl" "const char *be_name" "bool temporary" | .Fn be_activate "libbe_handle_t *hdl" "const char *be_name" "bool temporary" | ||||
.Ft int | .Ft int | ||||
.Fn be_destroy "libbe_handle_t *hdl" "const char *be_name" "int options" | .Fn be_destroy "libbe_handle_t *hdl" "const char *be_name" "int options" | ||||
.Pp | .Pp | ||||
.Ft void | .Ft void | ||||
.Fn be_nicenum "uint64_t num" "char *buf" "size_t bufsz" | .Fn be_nicenum "uint64_t num" "char *buf" "size_t bufsz" | ||||
.Pp | .Pp | ||||
.\" TODO: Write up of mount options | .\" TODO: Write up of mount options | ||||
▲ Show 20 Lines • Show All 147 Lines • ▼ Show 20 Lines | |||||
The | The | ||||
.Fn be_rename | .Fn be_rename | ||||
function renames a boot environment without unmounting it, as if renamed with | function renames a boot environment without unmounting it, as if renamed with | ||||
the | the | ||||
.Fl u | .Fl u | ||||
argument were passed to | argument were passed to | ||||
.Nm zfs | .Nm zfs | ||||
.Cm rename | .Cm rename | ||||
.Pp | |||||
The | |||||
.Fn be_nextboot_options | |||||
function sets nextboot options for the next boot. | |||||
This function is mutually exclusive with the | |||||
.Fn be_activate | |||||
function with the | |||||
.Fa temporary | |||||
flag set, as they both write to the same label area. | |||||
.Pp | .Pp | ||||
The | The | ||||
.Fn be_activate | .Fn be_activate | ||||
function makes a boot environment active on the next boot. | function makes a boot environment active on the next boot. | ||||
If the | If the | ||||
.Fa temporary | .Fa temporary | ||||
flag is set, then it will be active for the next boot only, as done by | flag is set, then it will be active for the next boot only, as done by | ||||
.Xr zfsbootcfg 8 . | .Xr zfsbootcfg 8 . | ||||
▲ Show 20 Lines • Show All 250 Lines • Show Last 20 Lines |