From owner-svn-soc-all@freebsd.org Tue Dec 1 22:14:48 2015 Return-Path: Delivered-To: svn-soc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 86E65A3C998 for ; Tue, 1 Dec 2015 22:14:48 +0000 (UTC) (envelope-from def@FreeBSD.org) Received: from socsvn.freebsd.org (socsvn.freebsd.org [IPv6:2001:1900:2254:206a::50:2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 77E3B1D03 for ; Tue, 1 Dec 2015 22:14:48 +0000 (UTC) (envelope-from def@FreeBSD.org) Received: from socsvn.freebsd.org ([127.0.1.124]) by socsvn.freebsd.org (8.15.2/8.15.2) with ESMTP id tB1MEm4m039647 for ; Tue, 1 Dec 2015 22:14:48 GMT (envelope-from def@FreeBSD.org) Received: (from www@localhost) by socsvn.freebsd.org (8.15.2/8.15.2/Submit) id tB1MElR8039602 for svn-soc-all@FreeBSD.org; Tue, 1 Dec 2015 22:14:47 GMT (envelope-from def@FreeBSD.org) Date: Tue, 1 Dec 2015 22:14:47 GMT Message-Id: <201512012214.tB1MElR8039602@socsvn.freebsd.org> X-Authentication-Warning: socsvn.freebsd.org: www set sender to def@FreeBSD.org using -f From: def@FreeBSD.org To: svn-soc-all@FreeBSD.org Subject: socsvn commit: r294715 - soc2013/def/crashdump-head/sbin/decryptcore MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-soc-all@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the entire Summer of Code repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Dec 2015 22:14:48 -0000 Author: def Date: Tue Dec 1 22:14:46 2015 New Revision: 294715 URL: http://svnweb.FreeBSD.org/socsvn/?view=rev&rev=294715 Log: Add manual page for decryptcore(8). Added: soc2013/def/crashdump-head/sbin/decryptcore/decryptcore.8 Modified: soc2013/def/crashdump-head/sbin/decryptcore/Makefile Modified: soc2013/def/crashdump-head/sbin/decryptcore/Makefile ============================================================================== --- soc2013/def/crashdump-head/sbin/decryptcore/Makefile Tue Dec 1 21:25:18 2015 (r294714) +++ soc2013/def/crashdump-head/sbin/decryptcore/Makefile Tue Dec 1 22:14:46 2015 (r294715) @@ -4,7 +4,7 @@ LIBADD= crypto pjdlog -MAN= +MAN= decryptcore.8 CFLAGS+=-I${.CURDIR}/../../sys CFLAGS+=-I${.CURDIR}/../../lib/libpjdlog Added: soc2013/def/crashdump-head/sbin/decryptcore/decryptcore.8 ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ soc2013/def/crashdump-head/sbin/decryptcore/decryptcore.8 Tue Dec 1 22:14:46 2015 (r294715) @@ -0,0 +1,81 @@ +.\" Copyright (c) 2015 The FreeBSD Foundation +.\" All rights reserved. +.\" +.\" 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. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``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 AUTHORS OR CONTRIBUTORS 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. +.\" +.Dd December 1, 2015 +.Dt DECRYPTCORE 8 +.Os +.Sh NAME +.Nm decryptcore +.Nd "decrypt a core dump of the operating system" +.Sh SYNOPSIS +.Nm +.Op Fl L +.Op Fl v +.Ar privatekey +.Ar encryptedkey +.Ar encryptedcore +.Ar decryptedcore +.Sh DESCRIPTION +The +.Nm +first decrypts +.Ar encryptedkey +using +.Ar privatekey +and then uses the resulting key to decrypt +.Ar encryptedcore +saved by +.Xr savecore 8 . +Result is saved in +.Ar decryptedcore . +.Pp +The +.Nm +utility can be started with the following command line arguments: +.Bl -tag -width ".Fl L" +.It Fl L +Write log messages to +.Xr syslogd 8 . +.It Fl v +Print or log verbose/debugging information. +This option can be specified multiple times to raise the verbosity +level. +.El +.Sh EXIT STATUS +The +.Nm +utility exits 0 on success, and >0 if an error occurs. +.Sh SEE ALSO +.Xr capsicum 4 , +.Xr dumpon 8 , +.Xr savecore 8 , +.Xr syslogd 8 +.Sh AUTHORS +The +.Nm +was implemented by +.An -nosplit +.An Konrad Witaszczyk Aq Mt def@FreeBSD.org +and +.An Pawel Jakub Dawidek Aq Mt pjd@FreeBSD.org .