12bcbcb59SWarner Losh.\" Copyright (c) 2017 Netflix, Inc 22bcbcb59SWarner Losh.\" All rights reserved. 32bcbcb59SWarner Losh.\" 42bcbcb59SWarner Losh.\" Redistribution and use in source and binary forms, with or without 52bcbcb59SWarner Losh.\" modification, are permitted provided that the following conditions 62bcbcb59SWarner Losh.\" are met: 72bcbcb59SWarner Losh.\" 1. Redistributions of source code must retain the above copyright 82bcbcb59SWarner Losh.\" notice, this list of conditions and the following disclaimer. 92bcbcb59SWarner Losh.\" 2. Redistributions in binary form must reproduce the above copyright 102bcbcb59SWarner Losh.\" notice, this list of conditions and the following disclaimer in the 112bcbcb59SWarner Losh.\" documentation and/or other materials provided with the distribution. 122bcbcb59SWarner Losh.\" 132bcbcb59SWarner Losh.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 142bcbcb59SWarner Losh.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 152bcbcb59SWarner Losh.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 162bcbcb59SWarner Losh.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 172bcbcb59SWarner Losh.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 182bcbcb59SWarner Losh.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 192bcbcb59SWarner Losh.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 202bcbcb59SWarner Losh.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 212bcbcb59SWarner Losh.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 222bcbcb59SWarner Losh.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 232bcbcb59SWarner Losh.\" SUCH DAMAGE. 242bcbcb59SWarner Losh.\" 252bcbcb59SWarner Losh.\" $FreeBSD$ 262bcbcb59SWarner Losh.\" 27*1c3a0e1aSWarner Losh.Dd November 21, 2017 282bcbcb59SWarner Losh.Dt EFIDP 8 292bcbcb59SWarner Losh.Os 302bcbcb59SWarner Losh.Sh NAME 312bcbcb59SWarner Losh.Nm efidp 322bcbcb59SWarner Losh.Nd UEFI Device Path manipulation 332bcbcb59SWarner Losh.Sh SYNOPSIS 342bcbcb59SWarner Losh.Nm 352bcbcb59SWarner Losh.Op Fl fp 362bcbcb59SWarner Losh.Op Fl -parse 372bcbcb59SWarner Losh.Op Fl -format 382bcbcb59SWarner Losh.Sh DESCRIPTION 39*1c3a0e1aSWarner LoshThis program converts 402bcbcb59SWarner Losh.Dq Unified Extensible Firmware Interface 412bcbcb59SWarner Losh.Pq UEFI 42*1c3a0e1aSWarner LoshDevice Paths, as defined in the UEFI standard, to and from binary form. 43*1c3a0e1aSWarner LoshBinary and textual forms are defined in Chapter 9 of the UEFI 44*1c3a0e1aSWarner LoshSpecification. 45*1c3a0e1aSWarner Losh.Pp 46*1c3a0e1aSWarner Losh.Bl -tag -width 20m 47*1c3a0e1aSWarner Losh.It Fl f Fl -format 48*1c3a0e1aSWarner LoshFormats a binary UEFI Device Path into its canonical UTF-8 textual form. 49*1c3a0e1aSWarner LoshA binary Device Path can be no longer than 8192 bytes. 50*1c3a0e1aSWarner LoshThe textual form must fit into 4096 bytes. 51*1c3a0e1aSWarner Losh.It Fl p Fl -parse 52*1c3a0e1aSWarner LoshParses a UEFI Device Path UTF-8 specification and outputs the binary 53*1c3a0e1aSWarner LoshDevice Path form. 54*1c3a0e1aSWarner LoshOnly one device path is parsed, even if there are multiple present in 55*1c3a0e1aSWarner Loshthe input. 56*1c3a0e1aSWarner LoshLeading white space is ignored. 57*1c3a0e1aSWarner LoshThe resulting binary Device Path can be no longer than 8192 bytes. 58*1c3a0e1aSWarner Losh.El 592bcbcb59SWarner Losh.Sh SEE ALSO 602bcbcb59SWarner LoshAppendix A of the UEFI specification has the format for GUIDs. 612bcbcb59SWarner LoshAll GUIDs 622bcbcb59SWarner Losh.Dq Globally Unique Identifiers 632bcbcb59SWarner Loshhave the format described in RFC 4122. 64*1c3a0e1aSWarner Losh.Pp 65*1c3a0e1aSWarner LoshThe Unified Extensible Firmware Interface Specification is available 66*1c3a0e1aSWarner Loshfrom 67*1c3a0e1aSWarner Losh.Pa www.uefi.org . 682bcbcb59SWarner Losh.Sh HISTORY 692bcbcb59SWarner LoshThe 702bcbcb59SWarner Losh.Nm 712bcbcb59SWarner Loshutility first appeared in 729a7af23fSGlen Barber.Fx 11.1 . 73