xref: /freebsd-src/share/man/man9/OF_package_to_path.9 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1*ac32b99cSOleksandr Tymoshenko.\"
2*ac32b99cSOleksandr Tymoshenko.\" Copyright (c) 2018 Oleksandr Tymoshenko <gonzo@FreeBSD.org>
3*ac32b99cSOleksandr Tymoshenko.\"
4*ac32b99cSOleksandr Tymoshenko.\" All rights reserved.
5*ac32b99cSOleksandr Tymoshenko.\"
6*ac32b99cSOleksandr Tymoshenko.\" Redistribution and use in source and binary forms, with or without
7*ac32b99cSOleksandr Tymoshenko.\" modification, are permitted provided that the following conditions
8*ac32b99cSOleksandr Tymoshenko.\" are met:
9*ac32b99cSOleksandr Tymoshenko.\" 1. Redistributions of source code must retain the above copyright
10*ac32b99cSOleksandr Tymoshenko.\"    notice, this list of conditions and the following disclaimer.
11*ac32b99cSOleksandr Tymoshenko.\" 2. Redistributions in binary form must reproduce the above copyright
12*ac32b99cSOleksandr Tymoshenko.\"    notice, this list of conditions and the following disclaimer in the
13*ac32b99cSOleksandr Tymoshenko.\"    documentation and/or other materials provided with the distribution.
14*ac32b99cSOleksandr Tymoshenko.\"
15*ac32b99cSOleksandr Tymoshenko.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
16*ac32b99cSOleksandr Tymoshenko.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17*ac32b99cSOleksandr Tymoshenko.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18*ac32b99cSOleksandr Tymoshenko.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
19*ac32b99cSOleksandr Tymoshenko.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20*ac32b99cSOleksandr Tymoshenko.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21*ac32b99cSOleksandr Tymoshenko.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22*ac32b99cSOleksandr Tymoshenko.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23*ac32b99cSOleksandr Tymoshenko.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24*ac32b99cSOleksandr Tymoshenko.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25*ac32b99cSOleksandr Tymoshenko.\"
26*ac32b99cSOleksandr Tymoshenko.Dd April 9, 2018
27*ac32b99cSOleksandr Tymoshenko.Dt OF_PACKAGE_TO_PATH 9
28*ac32b99cSOleksandr Tymoshenko.Os
29*ac32b99cSOleksandr Tymoshenko.Sh NAME
30*ac32b99cSOleksandr Tymoshenko.Nm OF_package_to_path
31*ac32b99cSOleksandr Tymoshenko.Nd get fully qualified path to a device tree node
32*ac32b99cSOleksandr Tymoshenko.Sh SYNOPSIS
33*ac32b99cSOleksandr Tymoshenko.In dev/ofw/ofw_bus.h
34*ac32b99cSOleksandr Tymoshenko.In dev/ofw/ofw_bus_subr.h
35*ac32b99cSOleksandr Tymoshenko.Ft ssize_t
36*ac32b99cSOleksandr Tymoshenko.Fn OF_package_to_path "phandle_t node" "char *buf" "size_t len"
37*ac32b99cSOleksandr Tymoshenko.Sh DESCRIPTION
38*ac32b99cSOleksandr Tymoshenko.Fn OF_package_to_path
39*ac32b99cSOleksandr Tymoshenkocopies at most
40*ac32b99cSOleksandr Tymoshenko.Fa len
41*ac32b99cSOleksandr Tymoshenkobytes of the fully qualified path to the device tree node
42*ac32b99cSOleksandr Tymoshenko.Fa node
43*ac32b99cSOleksandr Tymoshenkointo the memory specified by
44*ac32b99cSOleksandr Tymoshenko.Fa buf .
45*ac32b99cSOleksandr TymoshenkoThe function returns the number of bytes copied or -1 in case of the error.
46*ac32b99cSOleksandr Tymoshenko.Sh SEE ALSO
47*ac32b99cSOleksandr Tymoshenko.Xr OF_finddevice 9
48*ac32b99cSOleksandr Tymoshenko.Sh AUTHORS
49*ac32b99cSOleksandr Tymoshenko.An -nosplit
50*ac32b99cSOleksandr TymoshenkoThis manual page was written by
51*ac32b99cSOleksandr Tymoshenko.An Oleksandr Tymoshenko Aq Mt gonzo@FreeBSD.org .
52