2004-04-09 Sebastien Pouliot <sebastien@ximian.com>
[mono.git] / man / certmgr.1
1 .\" 
2 .\" certmgr manual page.
3 .\" Copyright 2004 Novell
4 .\" Author:
5 .\"   Sebastien Pouliot <sebastien@ximian.com>
6 .\"
7 .TH Mono "certmgr"
8 .SH NAME
9 certmgr \- Mono Certificate Manager (CLI version)
10 .SH SYNOPSIS
11 .PP
12 .B certmgr [action] [object type] [options] store [filename]
13 .SH DESCRIPTION
14 This tool allow to add, remove or extract certificates, certificate revocation 
15 lists (CRL) or certificate trust lists (CTL) to/from a certificate store. 
16 Certificate stores are used to build and validate certificate chains for 
17 Authenticode(r) code signing validation and SSL server certificates.
18 .SH ACTIONS
19 .TP
20 .I "-add"
21 Add a certificate, CRL or CTL to specified store.
22 .TP
23 .I "-del"
24 Remove a certificate, CRL or CTL from specified store.
25 .TP
26 .I "-put"
27 Copy a certificate, CRL or CTL from a store to a file.
28 .SH OBJECT TYPES
29 .TP
30 .I "-c", "-cert", "-certificate"
31 Add, Delete or Put certificates. That is the specified file must/will contains
32 X.509 certificates in DER binary encoding.
33 .TP
34 .I "-crl"
35 Add, Delete or Put certificate revocation lists (CRL). That is the specified 
36 file must/will contains X.509 CRL in DER binary encoding.
37 .TP
38 .I "-ctl"
39 Add, Delete or Put certificate trust lists (CRL). UNSUPPORTED.
40 .SH OPTIONS
41 .TP
42 .I "-v", "-verbose"
43 More details displayed on the console.
44 .TP
45 .I "-help", "-h", "-?", "/?"
46 Display help about this tool.
47 .SH FILES
48 .B WARNING: This details the current behavior of Mono and could change between releases.
49 The only safe way to interact with certificate stores is to use the certmgr
50 tool. The current releases of Mono keeps all the user certificate stores in 
51 separates directories under
52 .I ~/.mono/certs/
53 .TP
54 For example the trusted root certificates for a user would be kept under
55 .I ~/.mono/certs/Trust/
56 .TP
57 Certificates files are kept in DER (binary) format (extension .cer).
58 .TP
59 The filenames either starts with
60 .I tbp 
61 (thumbprint) or
62 .I ski
63 (subject key identifier).
64 .TP
65 The rest of the filename is the base64-encoded value (tbp or ski).
66 .SH AUTHOR
67 Written by Sebastien Pouliot
68 .SH COPYRIGHT
69 Copyright (C) 2004 Novell.
70 .SH MAILING LISTS
71 Visit http://mail.ximian.com/mailman/mono-list for details.
72 .SH WEB SITE
73 Visit: http://www.go-mono.com for details
74 .SH SEE ALSO
75 .BR makecert(1), setreg(1)