2009-03-11 16:49:54 +03:00
|
|
|
.\" $NetBSD: veriexec.4,v 1.20 2009/03/11 13:49:54 joerg Exp $
|
2005-04-24 17:09:48 +04:00
|
|
|
.\"
|
|
|
|
|
.\" Copyright 2005 Elad Efrat <elad@bsd.org.il>
|
|
|
|
|
.\" Copyright 2005 Brett Lymn <blymn@netbsd.org>
|
|
|
|
|
.\"
|
|
|
|
|
.\" This code is donated to The NetBSD Foundation by the author.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
|
.\" are met:
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
|
.\" 2. The name of the Author may not be used to endorse or promote
|
|
|
|
|
.\" products derived from this software without specific prior written
|
|
|
|
|
.\" permission.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
|
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE
|
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
|
.\"
|
2008-02-10 22:32:23 +03:00
|
|
|
.Dd February 10, 2008
|
2005-04-24 17:09:48 +04:00
|
|
|
.Dt VERIEXEC 4
|
2009-03-11 16:49:54 +03:00
|
|
|
.Os
|
2005-04-24 17:09:48 +04:00
|
|
|
.Sh NAME
|
|
|
|
|
.Nm veriexec
|
|
|
|
|
.Nd Veriexec pseudo-device
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Cd pseudo-device veriexec
|
|
|
|
|
.Sh DESCRIPTION
|
2006-10-28 19:34:18 +04:00
|
|
|
.Em Veriexec
|
2006-08-29 00:55:16 +04:00
|
|
|
verifies the integrity of specified executables and files before they are
|
|
|
|
|
run or read.
|
|
|
|
|
This makes it much more difficult to insert a trojan horse into the system
|
|
|
|
|
and also makes it more difficult to run binaries that are not supposed to
|
|
|
|
|
be running, for example, packet sniffers, DDoS clients and so on.
|
|
|
|
|
.Pp
|
2005-04-24 17:09:48 +04:00
|
|
|
The
|
|
|
|
|
.Nm
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
pseudo-device is used to load and delete entries to and from the in-kernel
|
2006-10-28 19:34:18 +04:00
|
|
|
.Em Veriexec
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
databases, as well as query information about them.
|
|
|
|
|
It can also be used to dump the entire database.
|
2006-11-29 01:22:02 +03:00
|
|
|
.Ss Kernel-userland interaction
|
|
|
|
|
.Em Veriexec
|
|
|
|
|
uses
|
|
|
|
|
.Xr proplib 3
|
|
|
|
|
for communication between the kernel and userland.
|
|
|
|
|
.Bl -tag -width XXXX
|
|
|
|
|
.It Dv VERIEXEC_LOAD
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
Load an entry for a file to be monitored by
|
|
|
|
|
.Em Veriexec .
|
2005-04-24 17:09:48 +04:00
|
|
|
.Pp
|
2006-11-29 01:22:02 +03:00
|
|
|
The dictionary passed contains the following elements:
|
|
|
|
|
.Bl -column entryxtype string
|
|
|
|
|
.It Sy Name Type Purpose
|
|
|
|
|
.It file string filename for this entry
|
|
|
|
|
.It entry-type uint8 entry type ( see below )
|
|
|
|
|
.It fp-type string fingerprint hashing algorithm
|
|
|
|
|
.It fp data the fingerprint
|
2005-04-24 17:09:48 +04:00
|
|
|
.El
|
|
|
|
|
.Pp
|
2006-11-29 01:22:02 +03:00
|
|
|
.Dq entry-type
|
|
|
|
|
can be one or more (binary-OR'd) of the following:
|
|
|
|
|
.Bl -column veriexecxuntrusted effect
|
|
|
|
|
.It Sy Type Effect
|
2006-12-23 11:45:55 +03:00
|
|
|
.It Dv VERIEXEC_DIRECT can execute directly
|
|
|
|
|
.It Dv VERIEXEC_INDIRECT can execute indirectly (interpreter, Xr mmap 2 )
|
|
|
|
|
.It Dv VERIEXEC_FILE can be opened
|
|
|
|
|
.It Dv VERIEXEC_UNTRUSTED located on untrusted storage
|
2006-11-29 01:22:02 +03:00
|
|
|
.El
|
|
|
|
|
.It Dv VERIEXEC_DELETE
|
|
|
|
|
Removes either an entry for a single file or entries for an entire mount from
|
|
|
|
|
.Em Veriexec .
|
2006-10-28 19:34:18 +04:00
|
|
|
.Pp
|
2006-11-29 01:22:02 +03:00
|
|
|
The dictionary passed contains the following elements:
|
|
|
|
|
.Bl -column file string
|
|
|
|
|
.It Sy Name Type Purpose
|
|
|
|
|
.It file string filename or mount-point
|
|
|
|
|
.El
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
.It Dv VERIEXEC_DUMP
|
|
|
|
|
Dump the
|
|
|
|
|
.Em Veriexec
|
|
|
|
|
monitored files database from the kernel.
|
|
|
|
|
.Pp
|
|
|
|
|
Only files that the filename is kept for them will be dumped.
|
|
|
|
|
The returned array contains dictionaries with the following elements:
|
|
|
|
|
.Bl -column entryxtype string
|
2009-03-11 16:49:54 +03:00
|
|
|
.It Sy Name Type Purpose
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
.It file string filename
|
|
|
|
|
.It fp-type string fingerprint hashing algorithm
|
|
|
|
|
.It fp data the fingerprint
|
|
|
|
|
.It entry-type uint8 entry type ( see above )
|
|
|
|
|
.El
|
|
|
|
|
.It Dv VERIEXEC_FLUSH
|
|
|
|
|
Flush the
|
|
|
|
|
.Em Veriexec
|
|
|
|
|
database, removing all entries.
|
|
|
|
|
.Pp
|
|
|
|
|
This command has no parameters.
|
2006-11-29 01:22:02 +03:00
|
|
|
.It Dv VERIEXEC_QUERY
|
|
|
|
|
Queries
|
|
|
|
|
.Em Veriexec
|
|
|
|
|
about a file, returning information that may be useful about it.
|
2006-10-28 19:34:18 +04:00
|
|
|
.Pp
|
2006-11-29 01:22:02 +03:00
|
|
|
The dictionary passed contains the following elements:
|
|
|
|
|
.Bl -column file string
|
|
|
|
|
.It Sy Name Type Purpose
|
|
|
|
|
.It file string filename
|
|
|
|
|
.El
|
2006-10-28 19:34:18 +04:00
|
|
|
.Pp
|
2006-11-29 01:22:02 +03:00
|
|
|
The dictionary returned contains the following elements:
|
|
|
|
|
.Bl -column entryxtype string
|
2009-03-11 16:49:54 +03:00
|
|
|
.It Sy Name Type Purpose
|
2006-11-29 01:22:02 +03:00
|
|
|
.It entry-type uint8 entry type ( see above )
|
|
|
|
|
.It status uint8 entry status
|
|
|
|
|
.It fp-type string fingerprint hashing algorithm
|
|
|
|
|
.It fp data the fingerprint
|
|
|
|
|
.El
|
2006-10-28 19:34:18 +04:00
|
|
|
.Pp
|
2006-11-29 01:22:02 +03:00
|
|
|
.Dq status
|
|
|
|
|
can be one of the following:
|
|
|
|
|
.Bl -column fingerprintxmismatch effect
|
|
|
|
|
.It Sy Status Meaning
|
2006-12-23 11:46:27 +03:00
|
|
|
.It Dv FINGERPRINT_NOTEVAL not evaluated
|
|
|
|
|
.It Dv FINGERPRINT_VALID fingerprint match
|
|
|
|
|
.It Dv FINGERPRINT_MISMATCH fingerprint mismatch
|
2006-11-29 01:22:02 +03:00
|
|
|
.El
|
2005-04-24 17:09:48 +04:00
|
|
|
.El
|
|
|
|
|
.Pp
|
|
|
|
|
Note that the requests
|
2005-12-10 05:10:00 +03:00
|
|
|
.Dv VERIEXEC_LOAD ,
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
.Dv VERIEXEC_DELETE ,
|
2005-04-24 17:09:48 +04:00
|
|
|
and
|
Some Veriexec stuff that's been rotting in my tree for months.
Bug fixes:
- Fix crash reported by Scott Ellis on current-users@.
- Fix race conditions in enforcing the Veriexec rename and remove
policies. These are NOT security issues.
- Fix memory leak in rename handling when overwriting a monitored
file.
- Fix table deletion logic.
- Don't prevent query requests if not in learning mode.
KPI updates:
- fileassoc_table_run() now takes a cookie to pass to the callback.
- veriexec_table_add() was removed, it is now done internally. As a
result, there's no longer a need for VERIEXEC_TABLESIZE.
- veriexec_report() was removed, it is now internal.
- Perform sanity checks on the entry type, and enforce default type
in veriexec_file_add() rather than in veriexecctl.
- Add veriexec_flush(), used to delete all Veriexec tables, and
veriexec_dump(), used to fill an array with all Veriexec entries.
New features:
- Add a '-k' flag to veriexecctl, to keep the filenames in the kernel
database. This allows Veriexec to produce slightly more accurate
logs under certain circumstances. In the future, this can be either
replaced by vnode->pathname translation, or combined with it.
- Add a VERIEXEC_DUMP ioctl, to dump the entire Veriexec database.
This can be used to recover a database if the file was lost.
Example usage:
# veriexecctl dump > /etc/signatures
Note that only entries with the filename kept (that is, were loaded
with the '-k' flag) will be dumped.
Idea from Brett Lymn.
- Add a VERIEXEC_FLUSH ioctl, to delete all Veriexec entries. Sample
usage:
# veriexecctl flush
- Add a 'veriexec_flags' rc(8) variable, and make its default have
the '-k' flag. On systems using the default signatures file
(generaetd from running 'veriexecgen' with no arguments), this will
use additional 32kb of kernel memory on average.
- Add a '-e' flag to veriexecctl, to evaluate the fingerprint during
load. This is done automatically for files marked as 'untrusted'.
Misc. stuff:
- The code for veriexecctl was massively simplified as a result of
eliminating the need for VERIEXEC_TABLESIZE, and now uses a single
pass of the signatures file, making the loading somewhat faster.
- Lots of minor fixes found using the (still under development)
Veriexec regression testsuite.
- Some of the messages Veriexec prints were improved.
- Various documentation fixes.
All relevant man-pages were updated to reflect the above changes.
Binary compatibility with existing veriexecctl binaries is maintained.
2007-05-15 23:47:43 +04:00
|
|
|
.Dv VERIEXEC_FLUSH
|
2006-10-28 19:34:18 +04:00
|
|
|
are not permitted once the strict level has been raised past 0.
|
2005-04-24 17:09:48 +04:00
|
|
|
.Sh SEE ALSO
|
2006-11-29 01:22:02 +03:00
|
|
|
.Xr proplib 3 ,
|
2005-08-02 22:54:53 +04:00
|
|
|
.Xr sysctl 3 ,
|
2008-02-10 22:32:23 +03:00
|
|
|
.Xr security 8 ,
|
2005-04-24 17:16:26 +04:00
|
|
|
.Xr sysctl 8 ,
|
2006-10-28 19:34:18 +04:00
|
|
|
.Xr veriexecctl 8 ,
|
|
|
|
|
.Xr veriexecgen 8 ,
|
|
|
|
|
.Xr veriexec 9
|
2005-04-24 17:09:48 +04:00
|
|
|
.Sh NOTES
|
2006-10-28 19:34:18 +04:00
|
|
|
.Nm
|
|
|
|
|
is part of the default configuration on the following architectures: amd64,
|
|
|
|
|
i386, prep, sparc64.
|
|
|
|
|
.Sh AUTHORS
|
|
|
|
|
.An Brett Lymn Aq blymn@NetBSD.org
|
|
|
|
|
.An Elad Efrat Aq elad@NetBSD.org
|