xref: /dflybsd-src/share/man/man4/padlock.4 (revision 755d70b8f2c28b016b6c0330273e7daa38038f27)
13e33542bSSascha Wildner.\" Copyright (c) 2005 Christian Brueffer
23e33542bSSascha Wildner.\" All rights reserved.
33e33542bSSascha Wildner.\"
43e33542bSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
53e33542bSSascha Wildner.\" modification, are permitted provided that the following conditions
63e33542bSSascha Wildner.\" are met:
73e33542bSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
83e33542bSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
93e33542bSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
103e33542bSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
113e33542bSSascha Wildner.\"    documentation and/or other materials provided with the distribution.
123e33542bSSascha Wildner.\"
133e33542bSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
143e33542bSSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
153e33542bSSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
163e33542bSSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
173e33542bSSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
183e33542bSSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
193e33542bSSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
203e33542bSSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
213e33542bSSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
223e33542bSSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
233e33542bSSascha Wildner.\" SUCH DAMAGE.
243e33542bSSascha Wildner.\"
253e33542bSSascha Wildner.\" $FreeBSD: src/share/man/man4/man4.i386/padlock.4,v 1.8 2007/08/02 08:04:48 bz Exp $
263e33542bSSascha Wildner.\"
27*755d70b8SSascha Wildner.Dd April 21, 2018
283e33542bSSascha Wildner.Dt PADLOCK 4
293e33542bSSascha Wildner.Os
303e33542bSSascha Wildner.Sh NAME
313e33542bSSascha Wildner.Nm padlock
323e33542bSSascha Wildner.Nd "driver for the cryptographic functions and RNG in VIA C3, C7 and Eden processors"
333e33542bSSascha Wildner.Sh SYNOPSIS
343e33542bSSascha WildnerTo compile this driver into the kernel,
353e33542bSSascha Wildnerplace the following lines in your
363e33542bSSascha Wildnerkernel configuration file:
373e33542bSSascha Wildner.Bd -ragged -offset indent
383e33542bSSascha Wildner.Cd "device crypto"
393e33542bSSascha Wildner.Cd "device padlock"
403e33542bSSascha Wildner.Ed
413e33542bSSascha Wildner.Pp
423e33542bSSascha WildnerAlternatively, to load the driver as a
433e33542bSSascha Wildnermodule at boot time, place the following line in
443e33542bSSascha Wildner.Xr loader.conf 5 :
453e33542bSSascha Wildner.Bd -literal -offset indent
463e33542bSSascha Wildnerpadlock_load="YES"
473e33542bSSascha Wildner.Ed
483e33542bSSascha Wildner.Sh DESCRIPTION
493e33542bSSascha WildnerThe C3 and Eden processor series from VIA include hardware acceleration for
503e33542bSSascha WildnerAES.
513e33542bSSascha WildnerThe C7 series includes hardware acceleration for AES, SHA1, SHA256 and RSA.
523e33542bSSascha WildnerAll of the above processor series include a hardware random number generator.
533e33542bSSascha Wildner.Pp
543e33542bSSascha WildnerThe
553e33542bSSascha Wildner.Nm
563e33542bSSascha Wildnerdriver registers itself to accelerate AES operations and, if available, HMAC/SHA1
573e33542bSSascha Wildnerand HMAC/SHA256 for
583e33542bSSascha Wildner.Xr crypto 4 .
593e33542bSSascha WildnerIt also registers itself to accelerate other HMAC algorithms, although
603e33542bSSascha Wildnerthere is no hardware acceleration for those algorithms.
61*755d70b8SSascha WildnerThis is due to historical reasons, so that padlock could work with
62*755d70b8SSascha Wildner.Em IPsec .
633e33542bSSascha Wildner.Pp
643e33542bSSascha WildnerThe hardware random number generator supplies data for the kernel
653e33542bSSascha Wildner.Xr random 4
663e33542bSSascha Wildnersubsystem.
673e33542bSSascha Wildner.Sh SEE ALSO
683e33542bSSascha Wildner.Xr crypt 3 ,
693e33542bSSascha Wildner.Xr crypto 4 ,
703e33542bSSascha Wildner.Xr intro 4 ,
713e33542bSSascha Wildner.Xr random 4 ,
723e33542bSSascha Wildner.Xr crypto 9
733e33542bSSascha Wildner.Sh HISTORY
743e33542bSSascha WildnerThe
753e33542bSSascha Wildner.Nm
763e33542bSSascha Wildnerdriver first appeared in
773e33542bSSascha Wildner.Ox .
783e33542bSSascha WildnerThe first
793e33542bSSascha Wildner.Fx
803e33542bSSascha Wildnerrelease to include it was
813e33542bSSascha Wildner.Fx 6.0 .
823e33542bSSascha Wildner.Pp
833e33542bSSascha WildnerIt was imported into
843e33542bSSascha Wildner.Dx 2.5 .
853e33542bSSascha Wildner.Sh AUTHORS
863e33542bSSascha Wildner.An -nosplit
873e33542bSSascha WildnerThe
883e33542bSSascha Wildner.Nm
893e33542bSSascha Wildnerdriver with AES encryption support was written by
90e18a87e3SFranco Fichtner.An Jason Wright Aq Mt jason@OpenBSD.org .
913e33542bSSascha WildnerIt was ported to
923e33542bSSascha Wildner.Fx
933e33542bSSascha Wildnerand then extended to support SHA1 and SHA256
943e33542bSSascha Wildnerby
95e18a87e3SFranco Fichtner.An Pawel Jakub Dawidek Aq Mt pjd@FreeBSD.org .
963e33542bSSascha WildnerThis manual page was written by
97e18a87e3SFranco Fichtner.An Christian Brueffer Aq Mt brueffer@FreeBSD.org .
98