code.delx.au - refind/blob - docs/man/mvrefind.8

   1 .\" Copyright 2015 Roderick W. Smith (rodsmith@rodsbooks.com)
   2 .\" May be distributed under the GNU Free Documentation License version 1.3 or
   3 any later version
   4 .TH "MVREFIND" "8" "0.10.1" "Roderick W. Smith" "rEFInd Manual"
   5 .SH "NAME"
   6 mvrefind \- Move a rEFInd installation from one location to another
   7 .SH "SYNOPSIS"
   8 .BI "mvrefind \fISOURCE DEST\fR"
   9
  10 .SH "DESCRIPTION"
  11
  12 Move a rEFInd installation from \fISOURCE\fR to \fIDEST\fR, where both
  13 \fISOURCE\fR and \fIDEST\fR are directories on the EFI System Partition
  14 (ESP), with \fISOURCE\fR containing a working rEFInd installation. This
  15 operation entails taking several actions:
  16
  17 .TP
  18 .B *
  19 Renaming the \fISOURCE\fR directory to \fIDEST\fR.
  20
  21 .TP
  22 .B *
  23 Renaming the rEFInd binary to a suitable value given the new destination.
  24 For instance, if \fIDEST\fR is EFI/BOOT on the EFI System Partition (ESP),
  25 the rEFInd binary should be \fIbootx64.efi\fR (or something similar but
  26 with a different architecture code).
  27
  28 .TP
  29 .B *
  30 Altering the computer's NVRAM entries to point to rEFInd at its new
  31 location.
  32
  33 .TP
  34 .B *
  35 If Shim is detected, renaming operations and NVRAM entry pointers are
  36 adjusted appropriately.
  37
  38 .TP
  39 .B *
  40 If the \fIDEST\fR exists, its contents are preserved.
  41
  42 .PP
  43
  44 Broadly speaking, \fImvrefind\fR understands three types of locations for
  45 both \fISOURCE\fR and \fIDEST\fR, relative to the root of the ESP:
  46
  47 .TP
  48 .B *
  49 \fBEFI/BOOT\fR -- The \fIbootx64.efi\fR (or similar for other
  50 architectures) filename in this location is the "fallback filename," which
  51 is used by removable boot media and as a boot loader of last resort on hard
  52 disks. Some EFIs can't remember their normal boot entries, and on them,
  53 rEFInd must be installed here (or as the Windows boot loader). When this
  54 directory is the \fIDEST\fR and it already exists, the existing
  55 \fIEFI/BOOT\fR is backed up to \fIEFI/BOOT\-rEFIndBackup\fR; and if the
  56 \fISOURCE\fR is \fIEFI/BOOT\fR and \fIEFI/BOOT\-rEFIndBackup\fR exists, it
  57 is renamed to \fIEFI/BOOT\fR after rEFInd is moved to its destination.
  58
  59 .TP
  60 .B *
  61 \fBEFI/Microsoft/boot\fR -- The \fIbootmgfw.efi\fR file in this location
  62 normally holds the Windows boot loader. Machines with broken EFIs may
  63 refuse to accept or remember proper boot entries and will instead boot this
  64 entry in preference to all others. In such cases, using rEFInd requires
  65 moving the Microsoft boot loader elsewhere and replacing it with rEFInd.
  66 When this directory is the \fIDEST\fR, \fImvrefind\fR moves the original
  67 \fIbootmgfw.efi\fR file down one level (to \fIEFI/Microsoft\fR) and stores
  68 \fIrefind_x64.efi\fR (or Shim) in that location. When moving from
  69 \fIEFI/Microsoft/boot\fR, this process is reversed.
  70
  71 .TP
  72 .B *
  73 \fBAnything else\fR -- Any other \fISOURCE\fR or \fIDEST\fR location is
  74 treated as a regular rEFInd installation, with a proper NVRAM entry created
  75 by \fIefibootmgr\fR.
  76
  77 .PP
  78
  79 \fImvrefind\fR attempts to identify the ESP and refuses to move between the
  80 ESP and any other partition. When it does move files, it moves the main
  81 rEFInd binary, the \fIrefind.conf\fR file, any identified Shim binary, and
  82 the \fIicons\fR, \fIicons\-backup\fR, \fIdrivers_*\fR, and \fIkeys\fR
  83 subdirectories. If other rEFInd files or directories are present in
  84 \fISOURCE\fR (such as a custom theme/icons directory), they will not be
  85 moved. If \fISOURCE\fR is empty after the specified files and
  86 subdirectories are moved, \fISOURCE\fR will be deleted.
  87
  88 .SH "AUTHORS"
  89 Primary author: Roderick W. Smith (rodsmith@rodsbooks.com)
  90
  91 .SH "SEE ALSO"
  92 \fBmkrlconf (8)\fR,
  93 \fBrefind-install (8)\fR
  94
  95 \fIhttp://www.rodsbooks.com/refind/\fR
  96
  97 .SH "AVAILABILITY"
  98 The \fBmvrefind\fR command is part of the \fIrEFInd\fR package and is
  99 available from Roderick W. Smith.