xref: /openbsd/usr.bin/ssh/ssh-pkcs11-helper.8 (revision f9ab0b1f)
1*f9ab0b1fSdjm.\" $OpenBSD: ssh-pkcs11-helper.8,v 1.7 2022/04/29 03:24:30 djm Exp $
23e04efbeSmarkus.\"
33e04efbeSmarkus.\" Copyright (c) 2010 Markus Friedl.  All rights reserved.
43e04efbeSmarkus.\"
53e04efbeSmarkus.\" Permission to use, copy, modify, and distribute this software for any
63e04efbeSmarkus.\" purpose with or without fee is hereby granted, provided that the above
73e04efbeSmarkus.\" copyright notice and this permission notice appear in all copies.
83e04efbeSmarkus.\"
93e04efbeSmarkus.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
103e04efbeSmarkus.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
113e04efbeSmarkus.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
123e04efbeSmarkus.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
133e04efbeSmarkus.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
143e04efbeSmarkus.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
153e04efbeSmarkus.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
163e04efbeSmarkus.\"
17*f9ab0b1fSdjm.Dd $Mdocdate: April 29 2022 $
183e04efbeSmarkus.Dt SSH-PKCS11-HELPER 8
193e04efbeSmarkus.Os
203e04efbeSmarkus.Sh NAME
213e04efbeSmarkus.Nm ssh-pkcs11-helper
221890c57dSjmc.Nd OpenSSH helper for PKCS#11 support
233e04efbeSmarkus.Sh SYNOPSIS
243e04efbeSmarkus.Nm
259f07e697Sdjm.Op Fl v
263e04efbeSmarkus.Sh DESCRIPTION
273e04efbeSmarkus.Nm
283e04efbeSmarkusis used by
29*f9ab0b1fSdjm.Xr ssh 1 ,
30*f9ab0b1fSdjm.Xr ssh-agent 1 ,
31*f9ab0b1fSdjmand
32*f9ab0b1fSdjm.Xr ssh-keygen 1
3391bee2fcSmarkusto access keys provided by a PKCS#11 token.
343e04efbeSmarkus.Pp
353e04efbeSmarkus.Nm
36*f9ab0b1fSdjmis not intended to be invoked directly by the user.
379f07e697Sdjm.Pp
389f07e697SdjmA single option is supported:
399f07e697Sdjm.Bl -tag -width Ds
409f07e697Sdjm.It Fl v
419f07e697SdjmVerbose mode.
429f07e697SdjmCauses
439f07e697Sdjm.Nm
449f07e697Sdjmto print debugging messages about its progress.
459f07e697SdjmThis is helpful in debugging problems.
469f07e697SdjmMultiple
479f07e697Sdjm.Fl v
489f07e697Sdjmoptions increase the verbosity.
499f07e697SdjmThe maximum is 3.
509f07e697Sdjm.Pp
519f07e697SdjmNote that
52*f9ab0b1fSdjm.Xr ssh 1 ,
53*f9ab0b1fSdjm.Xr ssh-agent 1 ,
54*f9ab0b1fSdjmand
55*f9ab0b1fSdjm.Xr ssh-keygen 1
569f07e697Sdjmwill automatically pass the
579f07e697Sdjm.Fl v
589f07e697Sdjmflag to
599f07e697Sdjm.Nm
60*f9ab0b1fSdjmwhen they have themselves been placed in debug mode.
619f07e697Sdjm.El
623e04efbeSmarkus.Sh SEE ALSO
633e04efbeSmarkus.Xr ssh 1 ,
64*f9ab0b1fSdjm.Xr ssh-agent 1 ,
65*f9ab0b1fSdjm.Xr ssh-keygen 1
663e04efbeSmarkus.Sh HISTORY
673e04efbeSmarkus.Nm
683e04efbeSmarkusfirst appeared in
693e04efbeSmarkus.Ox 4.7 .
703e04efbeSmarkus.Sh AUTHORS
7176c04420Sschwarze.An Markus Friedl Aq Mt markus@openbsd.org
72