man/portsreinstall-chroot-mount.8

   1 .\" ==================================================================================
   2 .\" portsreinstall-chroot-mount(8) manual page
   3 .\" Copyright (C) 2018 Mamoru Sakaue, MwGhennndo, All Rights Reserved.
   4 .\" ==================================================================================
   5 .TH PORTSREINSTALL\-CHROOT\-MOUNT 8 "13 September 2018" "FreeBSD" "FreeBSD System Manager's Manual"
   6 .SH NAME
   7 portsreinstall\-chroot\-mount \- Support utility for \fBportsreinstall\fR(8) to mount and unmount a builder environment at the grand host environment
   8 .SH SYNOPSIS
   9 .B portsreinstall-chroot-mount
  10 [
  11 .I
  12 OPTIONS
  13 ] [
  14 .B
  15 \-\-
  16 ] [
  17 .I
  18 command
  19 ]
  20 .SH DESCRIPTION
  21 This utility is for assisting \fBportsreinstall\-chroot\fR(8) to mount and unmount a builder environment at the grand host environment in case that the target environment is a \fBchroot\fR(8) or \fBjail\fR(8) virtual environment which does not have sufficient privilege to operate the file systems.
  22 Execution of this utility will be suggested by \fBportsreinstall\-chroot\fR(8) executed at the target environment.
  23 The executable file of this utility is installed outside the scope of the search paths, and expected to be launched by specifying the full path.
  24 .SH ROBUSTNESS AGAINST TERMINATION AND RESTART
  25 Execution of this utility can be terminated at any points and restarted from there.
  26 .SH ARGUMENTS
  27 One of the following \fIcommands\fR can be given for optional operations or confirmation.
  28 .TP
  29 \fBmount\fR
  30 (Default) Mount file systems for the builder \fBchroot\fR(8) environment inside the target \fBchroot\fR(8) or \fBjail\fR(8) environment.
  31 .TP
  32 \fBunmount\fR
  33 Unmount file systems for the builder \fBchroot\fR(8) environment inside the target \fBchroot\fR(8) or \fBjail\fR(8) environment.
  34 .TP
  35 .RE
  36 .SH OPTIONS
  37 If duplicated or conflicting ones are set, the last ones are effective.
  38 The end of options can be explicitly specified by \fB\-\-\fR.
  39 Short options can be given in compact forms, for example, \fB\-V \-a\fR to be \fB\-Va\fR.
  40 .PD
  41 .SS Group 1: Just show messages and exit without operation
  42 .IP \fB\-H\fR
  43 .PD 0
  44 .TP
  45 \fB\-\-long\-help\fR
  46 Show a long help whose content is the same as the manual page.
  47 .PD
  48 .IP \fB\-h\fR
  49 .PD 0
  50 .TP
  51 \fB\-\-help\fR
  52 .PD 0
  53 .TP
  54 \fB\-\-short\-help\fR
  55 Show a short help.
  56 .PD
  57 .IP \fB\-V\fR
  58 .PD 0
  59 .TP
  60 \fB\-\-show\-version\fR
  61 Show the current version.
  62 .PD
  63 .SS Group 2: Effective anytime
  64 .IP \fB\-a\fR
  65 .PD 0
  66 .TP
  67 \fB\-\-batch\-mode\fR
  68 Suppress messages so as to be friendly for batch operations.
  69 Comments are suppressed as much as possible.
  70 .PD
  71 .IP \fB\-f\fR
  72 .PD 0
  73 .TP
  74 \fB\-\-forcible\-operation\fR
  75 Forcibly carry out operations be ignoring the lock in case that file systems are set to be mounted/unmounted from inside the
  76 virtual (chroot or jail) environment.
  77 .PD
  78 .IP \fB\-S\fR
  79 .PD 0
  80 .TP
  81 \fB\-\-no\-opening\-message\fR
  82 Suppress the credit, opening and terminating messages.
  83 Option \fB\-a\fR takes higher priority over this option.
  84 .PD
  85 .SH DETAILS
  86 .SS Overview
  87 \fBportsreinstall\-chroot\fR(8) provides functionality to carry out package build at a builder \fBchroot\fR(8) environment which is mounted onto the target environment.
  88 It is designed to be also executable even when the target is \fBchroot\fR(8) or \fBjail\fR(8) environment although such environment may not have sufficient privilege to operate the file systems.
  89 In such case, \fBportsreinstall\-chroot\fR(8) once terminates its execution and suggests the user to execute this utility at the grand host environment.
  90 There is no need to install \fBportsreinstall\fR(8) and its family in the grand host environment, and the user will be suggested to specify the full path to this utility installed in the target \fBchroot\fR(8) or \fBjail\fR(8) environment.
  91 .SH "ENVIRONMENT VARIABLES"
  92 See the corresponding section of \fBportsreinstall\fR(8).
  93 The variables are conveyed to the forked environment from the target host.
  94 .SH HISTORY
  95 This utility first appeared as a part of \fBportsreinstall\fR(8) version 4.0.0 released on June 29, 2018.
  96 .SH "SEE ALSO"
  97 \fBportsreinstall\fR(8),
  98 \fBportsreinstall\-chroot\fR(8),
  99 \fBportsreinstall\-upgrade\fR(8).
 100 .SH COPYRIGHT
 101 This software is distributed under the 2-Clause BSD License.
 102 .PP
 103 (C)\ 2018\ Mamoru\ Sakaue,\ MwGhennndo,\ All\ Rights\ Reserved.
 104 .PP
 105 Email:\ sakaue.mamoru@samurai.mwghennn.net
 106 .PP
 107 Homepage:\ http://www.mwghennndo.com/software/portsreinstall/