<?xml version="1.0"?>
<?xml-stylesheet type="text/css" href="https://openzfsonosx.org/w/skins/common/feed.css?303"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
		<id>https://openzfsonosx.org/w/index.php?action=history&amp;feed=atom&amp;title=Bless</id>
		<title>Bless - Revision history</title>
		<link rel="self" type="application/atom+xml" href="https://openzfsonosx.org/w/index.php?action=history&amp;feed=atom&amp;title=Bless"/>
		<link rel="alternate" type="text/html" href="https://openzfsonosx.org/w/index.php?title=Bless&amp;action=history"/>
		<updated>2026-04-19T14:42:09Z</updated>
		<subtitle>Revision history for this page on the wiki</subtitle>
		<generator>MediaWiki 1.22.3</generator>

	<entry>
		<id>https://openzfsonosx.org/w/index.php?title=Bless&amp;diff=1101&amp;oldid=prev</id>
		<title>Evansus: Created page with &quot;Using a layout as specified in ZFS on Boot, using disk1:  The simplest version of this command will locate the boot helper following the ZFS partition:  # sudo bless --dev...&quot;</title>
		<link rel="alternate" type="text/html" href="https://openzfsonosx.org/w/index.php?title=Bless&amp;diff=1101&amp;oldid=prev"/>
				<updated>2016-07-27T06:43:54Z</updated>
		
		<summary type="html">&lt;p&gt;Created page with &amp;quot;Using a layout as specified in &lt;a href=&quot;/wiki/ZFS_on_Boot&quot; title=&quot;ZFS on Boot&quot;&gt;ZFS on Boot&lt;/a&gt;, using disk1:  The simplest version of this command will locate the boot helper following the ZFS partition:  # sudo bless --dev...&amp;quot;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;Using a layout as specified in [[ZFS on Boot]], using disk1:&lt;br /&gt;
&lt;br /&gt;
The simplest version of this command will locate the boot helper following the ZFS partition:&lt;br /&gt;
 # sudo bless --device /dev/disk1s2 --setBoot --verbose&lt;br /&gt;
&lt;br /&gt;
Currently --folder and --mount options will work (partially) but may select the wrong boot helper if there are multiple bootable ZFS pools.&lt;br /&gt;
(For example, if you have ZFS boot setup on both the internal disk and an external disk.)&lt;br /&gt;
 # sudo bless --folder /Volumes/Capitan --setBoot --verbose&lt;br /&gt;
 # sudo bless --mount /Volumes/Capitan --setBoot --verbose&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is an undocumented environment variable that can resolve the conflict. For example, if the ZFS pool is located on disk3s2, and the boot helper is disk3s3:&lt;br /&gt;
 # sudo bless --mount /Volumes/Capitan --setBoot --verbose&lt;br /&gt;
 { ... Truncated output ... }&lt;br /&gt;
 Returning booter information dictionary:&lt;br /&gt;
 &amp;lt;CFBasicHash 0x7fd7c2400a30 [0x7fff75c10440]&amp;gt;{type = mutable dict, count = 3, entries =&amp;gt;&lt;br /&gt;
        0 : &amp;lt;CFString 0x10bd97990 [0x7fff75c10440]&amp;gt;{contents = &amp;quot;System Partitions&amp;quot;} = (&lt;br /&gt;
    disk1s1,&lt;br /&gt;
    disk0s1,&lt;br /&gt;
    disk2s1,&lt;br /&gt;
    disk3s1&lt;br /&gt;
 )&lt;br /&gt;
        1 : &amp;lt;CFString 0x10bd98170 [0x7fff75c10440]&amp;gt;{contents = &amp;quot;Data Partitions&amp;quot;} = (&lt;br /&gt;
    disk1s2,&lt;br /&gt;
    disk2s2,&lt;br /&gt;
    disk3s2&lt;br /&gt;
 )&lt;br /&gt;
        2 : &amp;lt;CFString 0x10bd98190 [0x7fff75c10440]&amp;gt;{contents = &amp;quot;Auxiliary Partitions&amp;quot;} = (&lt;br /&gt;
    '''disk1s3,'''&lt;br /&gt;
    disk2s3,&lt;br /&gt;
    '''disk3s3'''&lt;br /&gt;
 )&lt;br /&gt;
 }&lt;br /&gt;
 Substituting booter '''disk1s3'''&lt;br /&gt;
 { ... Truncated output ... }&lt;br /&gt;
&lt;br /&gt;
Adding an environment variable 'BL_PRIMARY_BOOTER_INDEX' can instruct bless to use the correct partition. The index will start from 0 and count upwards in the list of &amp;quot;Auxiliary Partitions&amp;quot;&lt;br /&gt;
&lt;br /&gt;
In this case, the pool is located on disk3s2 and the boot helper is disk3s3, so adding an index of '''2''' will select the third boot device:&lt;br /&gt;
 # sudo env BL_PRIMARY_BOOTER_INDEX=2 bless --mount /Volumes/Capitan --setBoot --verbose&lt;br /&gt;
 { ... Truncated output ... }&lt;br /&gt;
 Returning booter information dictionary:&lt;br /&gt;
 &amp;lt;CFBasicHash 0x7fd7c2400a30 [0x7fff75c10440]&amp;gt;{type = mutable dict, count = 3, entries =&amp;gt;&lt;br /&gt;
        0 : &amp;lt;CFString 0x10bd97990 [0x7fff75c10440]&amp;gt;{contents = &amp;quot;System Partitions&amp;quot;} = (&lt;br /&gt;
    disk3s1,&lt;br /&gt;
    disk1s1,&lt;br /&gt;
    disk0s1,&lt;br /&gt;
    disk2s1&lt;br /&gt;
 )&lt;br /&gt;
        1 : &amp;lt;CFString 0x10bd98170 [0x7fff75c10440]&amp;gt;{contents = &amp;quot;Data Partitions&amp;quot;} = (&lt;br /&gt;
    disk3s2,&lt;br /&gt;
    disk1s2,&lt;br /&gt;
    disk2s2&lt;br /&gt;
 )&lt;br /&gt;
        2 : &amp;lt;CFString 0x10bd98190 [0x7fff75c10440]&amp;gt;{contents = &amp;quot;Auxiliary Partitions&amp;quot;} = (&lt;br /&gt;
    '''disk3s3,'''&lt;br /&gt;
    disk1s3,&lt;br /&gt;
    disk2s3&lt;br /&gt;
 )&lt;br /&gt;
 }&lt;br /&gt;
 { ... Truncated output ... }&lt;br /&gt;
 Substituting booter '''disk3s3'''&lt;br /&gt;
 IOMedia '''disk3s3''' has UUID 4C5E73A9-05D0-4B7F-A6A8-050715D620A0&lt;br /&gt;
 Setting EFI NVRAM:&lt;br /&gt;
        efi-boot-device='&amp;lt;array&amp;gt;&amp;lt;dict&amp;gt;&amp;lt;key&amp;gt;IOMatch&amp;lt;/key&amp;gt;&amp;lt;dict&amp;gt;&amp;lt;key&amp;gt;IOProviderClass&amp;lt;/key&amp;gt;&lt;br /&gt;
 &amp;lt;string&amp;gt;IOMedia&amp;lt;/string&amp;gt;&amp;lt;key&amp;gt;IOPropertyMatch&amp;lt;/key&amp;gt;&lt;br /&gt;
 &amp;lt;dict&amp;gt;&amp;lt;key&amp;gt;UUID&amp;lt;/key&amp;gt;&amp;lt;string&amp;gt;4C5E73A9-05D0-4B7F-A6A8-050715D620A0&amp;lt;/string&amp;gt;&amp;lt;/dict&amp;gt;&amp;lt;/dict&amp;gt;&lt;br /&gt;
 &amp;lt;key&amp;gt;BLLastBSDName&amp;lt;/key&amp;gt;&amp;lt;string&amp;gt;'''disk3s3'''&amp;lt;/string&amp;gt;&amp;lt;/dict&amp;gt;&amp;lt;/array&amp;gt;'&lt;br /&gt;
 { ... Truncated output ... }&lt;/div&gt;</summary>
		<author><name>Evansus</name></author>	</entry>

	</feed>