usr/src/man/man1m/wanboot_p12split.1m

   1 '\" te
   2 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH WANBOOT_P12SPLIT 1M "Apr 18, 2003"
   7 .SH NAME
   8 wanboot_p12split \- split a PKCS #12 file into separate certificate and key
   9 files
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/lib/inet/wanboot/p12split\fR \fB-i\fR \fIp12file\fR \fB-c\fR \fIout_cert\fR \fB-k\fR \fIout_key\fR
  14      [\fB-t\fR \fIout_trust\fR \fB-l\fR \fIid\fR \fB-v\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The \fBp12split\fR utility extracts a certificate and private key from the
  21 repository specified by \fIp12file\fR, depositing the certificate in
  22 \fIout_cert\fR and the key in \fIout_key\fR. If supplied, the \fB-l\fR option
  23 specifies the value for the \fBLocalKeyId\fR that will be used in the new
  24 certificate and key files. \fBp12split\fR can optionally extract a trust
  25 certificate into the \fIout_trust\fR file if the \fB-t\fR option is specified.
  26 Use the \fB-v\fR option to get a verbose description of the split displayed to
  27 standard output.
  28 .SH OPTIONS
  29 .sp
  30 .LP
  31 The following arguments and options are supported:
  32 .sp
  33 .ne 2
  34 .na
  35 \fB\fB-c\fR \fIout_cert\fR\fR
  36 .ad
  37 .RS 16n
  38 Specifies a repository that receives a extracted certificate.
  39 .RE
  40
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fB-i\fR \fIp12file\fR\fR
  45 .ad
  46 .RS 16n
  47 Specifies a repository from which a certificate and private key is extracted.
  48 .RE
  49
  50 .sp
  51 .ne 2
  52 .na
  53 \fB\fB-k\fR \fIout_key\fR\fR
  54 .ad
  55 .RS 16n
  56 Specifies a repository that receives a extracted private key.
  57 .RE
  58
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fB-l\fR \fIid\fR\fR
  63 .ad
  64 .RS 16n
  65 Specifies the value for the \fBLocalKeyId\fR that will be used in the new
  66 certificate and key files.
  67 .RE
  68
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fB-t\fR \fIout_trust\fR\fR
  73 .ad
  74 .RS 16n
  75 Specifies a file for receiving an extracted trust certificate.
  76 .RE
  77
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fB-v\fR\fR
  82 .ad
  83 .RS 16n
  84 Displays a verbose description of the split to stdout.
  85 .RE
  86
  87 .SH EXIT STATUS
  88 .sp
  89 .ne 2
  90 .na
  91 \fB\fB0\fR\fR
  92 .ad
  93 .RS 6n
  94 Successful operation.
  95 .RE
  96
  97 .sp
  98 .ne 2
  99 .na
 100 \fB\fB>0\fR\fR
 101 .ad
 102 .RS 6n
 103 An error occurred.
 104 .RE
 105
 106 .SH ATTRIBUTES
 107 .sp
 108 .LP
 109 See \fBattributes\fR(5) for descriptions of the following attributes:
 110 .sp
 111
 112 .sp
 113 .TS
 114 box;
 115 c | c
 116 l | l .
 117 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 118 _
 119 Interface Stability     Unstable
 120 .TE
 121
 122 .SH SEE ALSO
 123 .sp
 124 .LP
 125 \fBattributes\fR(5)