xref: /freebsd/lib/libveriexec/veriexec.3 (revision 6e1fc0118033f42b7c0d3623c8f67a89ebecabb2)
1b6b5dcf2SStephen J. Kiernan.\" Copyright (c) 2018, Juniper Networks, Inc.
2b6b5dcf2SStephen J. Kiernan.\" All rights reserved.
3b6b5dcf2SStephen J. Kiernan.\"
4b6b5dcf2SStephen J. Kiernan.\" Redistribution and use in source and binary forms, with or without
5b6b5dcf2SStephen J. Kiernan.\" modification, are permitted provided that the following conditions
6b6b5dcf2SStephen J. Kiernan.\" are met:
7b6b5dcf2SStephen J. Kiernan.\" 1. Redistributions of source code must retain the above copyright
8b6b5dcf2SStephen J. Kiernan.\"    notice, this list of conditions and the following disclaimer.
9b6b5dcf2SStephen J. Kiernan.\" 2. Redistributions in binary form must reproduce the above copyright
10b6b5dcf2SStephen J. Kiernan.\"    notice, this list of conditions and the following disclaimer in the
11b6b5dcf2SStephen J. Kiernan.\"    documentation and/or other materials provided with the distribution.
12b6b5dcf2SStephen J. Kiernan.\"
13b6b5dcf2SStephen J. Kiernan.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14b6b5dcf2SStephen J. Kiernan.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15b6b5dcf2SStephen J. Kiernan.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16b6b5dcf2SStephen J. Kiernan.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17b6b5dcf2SStephen J. Kiernan.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18b6b5dcf2SStephen J. Kiernan.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19b6b5dcf2SStephen J. Kiernan.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20b6b5dcf2SStephen J. Kiernan.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21b6b5dcf2SStephen J. Kiernan.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22b6b5dcf2SStephen J. Kiernan.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23b6b5dcf2SStephen J. Kiernan.\" SUCH DAMAGE.
24b6b5dcf2SStephen J. Kiernan.\"
25b6b5dcf2SStephen J. Kiernan.Dd June 19, 2018
26b6b5dcf2SStephen J. Kiernan.Dt VERIEXEC 3
27b6b5dcf2SStephen J. Kiernan.Os
28b6b5dcf2SStephen J. Kiernan.Sh NAME
29b6b5dcf2SStephen J. Kiernan.Nm veriexec_check_fd ,
30b6b5dcf2SStephen J. Kiernan.Nm veriexec_check_path
31b6b5dcf2SStephen J. Kiernan.Nd Verified execution routines
32b6b5dcf2SStephen J. Kiernan.Sh LIBRARY
33b6b5dcf2SStephen J. Kiernan.Lb libveriexec
34b6b5dcf2SStephen J. Kiernan.Sh SYNOPSIS
35b6b5dcf2SStephen J. Kiernan.In libveriexec.h
36b6b5dcf2SStephen J. Kiernan.Ft int
37b6b5dcf2SStephen J. Kiernan.Fn veriexec_check_fd "int fd"
38b6b5dcf2SStephen J. Kiernan.Ft int
39b6b5dcf2SStephen J. Kiernan.Fn veriexec_check_path "const char *file"
40b6b5dcf2SStephen J. Kiernan.Sh DESCRIPTION
41b6b5dcf2SStephen J. KiernanThe
42b6b5dcf2SStephen J. Kiernan.Fn veriexec_check_fd
43b6b5dcf2SStephen J. Kiernanfunction checks the signature of the file represented by the
44b6b5dcf2SStephen J. Kiernan.Fa fd
45b6b5dcf2SStephen J. Kiernanfile descriptor.
46b6b5dcf2SStephen J. Kiernan.Pp
47b6b5dcf2SStephen J. KiernanThe
48b6b5dcf2SStephen J. Kiernan.Fn veriexec_check_path
49b6b5dcf2SStephen J. Kiernanfunction checks the signature of the file path
50b6b5dcf2SStephen J. Kiernan.Fa file .
51b6b5dcf2SStephen J. Kiernan.Pp
52b6b5dcf2SStephen J. KiernanThe
53b6b5dcf2SStephen J. Kiernan.Fn veriexec_check_fd
54b6b5dcf2SStephen J. Kiernanand
55b6b5dcf2SStephen J. Kiernan.Fn veriexec_check_path
56b6b5dcf2SStephen J. Kiernanfunctions return zero on a successful signature match or if veriexec is not
57b6b5dcf2SStephen J. Kiernanenabled.
58b6b5dcf2SStephen J. KiernanIf the signature does not match,
59b6b5dcf2SStephen J. Kiernan.Va errno
60b6b5dcf2SStephen J. Kiernanis set to the reason for the mismatch.
61b6b5dcf2SStephen J. Kiernan.Sh SEE ALSO
62*6e1fc011SGraham Percival.Xr mac_veriexec 4 ,
63b6b5dcf2SStephen J. Kiernan.Xr veriexec 4
64