btxld: port build tool from freebsd
[unleashed.git] / usr / src / tools / codesign / signit.1onbld
blob491e5312d115ebe05d6de5c0bd69c8507592b482
1 .\"
2 .\" CDDL HEADER START
3 .\"
4 .\" The contents of this file are subject to the terms of the
5 .\" Common Development and Distribution License (the "License").
6 .\" You may not use this file except in compliance with the License.
7 .\"
8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 .\" or http://www.opensolaris.org/os/licensing.
10 .\" See the License for the specific language governing permissions
11 .\" and limitations under the License.
12 .\"
13 .\" When distributing Covered Code, include this CDDL HEADER in each
14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 .\" If applicable, add the following below this CDDL HEADER, with the
16 .\" fields enclosed by brackets "[]" replaced with your own identifying
17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
18 .\"
19 .\" CDDL HEADER END
20 .\"
21 .\" Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
22 .\" Use is subject to license terms.
23 .\"
24 .TH SIGNIT 1ONBLD "Jun 13, 2007"
25 .SH NAME
26 .I signit
27 \- sign files using code signing server
28 .SH SYNOPSIS
29 \fBsignit [-q] [-i dir] [-o dir] [-l user]\fP
30 .SH DESCRIPTION
31 .LP
32 .I signit
33 is the client program for use with Sun's code signing server. It
34 reads a list of signing credential names and relative pathnames
35 from standard input. Each file is read from the input directory,
36 sent to the signing server, signed with the specified credential,
37 and written to the output directory.
38 .SH OPTIONS
39 .LP
40 The following options are supported:
41 .TP 4
42 .B \-q
43 Quiet operation: This option suppresses printing the names of files
44 that are signed successfully.
45 .TP 4
46 .B -i \fIdir\fP
47 Specifies the base input directory from which the relative pathnames
48 of files to be signed are interpreted. If not specified, the
49 input directory defaults to the current directory.
50 .TP 4
51 .B -o \fIdir\fP
52 Specifies the base output directory to which signed files
53 are written.  If not specified, the
54 output directory matches the input directory.
55 .TP 4
56 .B -l \fIuser\fP
57 Specifies the user login name on the code signing server. If not
58 specified, the login name of the user running
59 .I signit
60 is used.
61 .SH ENVIRONMENT
62 .TP 4
63 .B CODESIGN_SERVER
64 Specifies the hostname or IP address of the code signing server. If
65 this variable is not set, it defaults to quill.sfbay.
66 .SH EXIT STATUS
67 .LP
68 The following exit status values are returned:
69 .IP "\fB0\fR" 4
70 All specified files were signed successfully.
71 .IP "\fB1\fR" 4
72 One or more files were not signed successfully.
73 .SH SEE ALSO
74 .LP
75 signproto(1ONBLD)