.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH rage-keygen 1  "rage-keygen 0.10.0" 
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
rage\-keygen \- Generate age\-compatible encryption key pairs
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH SYNOPSIS
\fBrage\-keygen\fR [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-y \fR] [\fIINPUT\fR] 
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH DESCRIPTION
rage\-keygen generates a new native age key pair, and outputs the identity to
standard output or to the OUTPUT file. The output includes the public key and
the current time as comments.
.PP
If the output is not going to a terminal, rage\-keygen prints the public key to
standard error.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print this help message and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version info and exit.
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIOUTPUT\fR
Write the identity to OUTPUT instead of standard output.

If OUTPUT already exists, it is not overwritten.
.TP
\fB\-y\fR
Read an identity file from INPUT or from standard input and output the
corresponding recipient(s), one per line, with no comments.
.TP
[\fIINPUT\fR]
Path to a file to read from.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH EXAMPLES
.TP
Generate a new identity:
.br
\fB$ rage\-keygen\fR
.br
# 已創建: 2021\-01\-02T15:30:45+01:00
.br
# 公鑰: age1lvyvwawkr0mcnnnncaghunadrqkmuf9e6507x9y920xxpp866cnql7dp2z
.br
AGE\-SECRET\-KEY\-1N9JEPW6DWJ0ZQUDX63F5A03GX8QUW7PXDE39N8UYF82VZ9PC8UFS3M7XA9
.br

.br

.TP
Write a new identity to "key.txt":
.br
\fB$ rage\-keygen \-o key.txt\fR
.br
公鑰: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p
.br

.br

.TP
Convert an identity to a recipient:
.br
\fB$ rage\-keygen \-y key.txt\fR
.br
age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p
.br

.br

.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH "SEE ALSO"
rage(1), rage\-mount(1)
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH VERSION
v0.10.0
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH AUTHORS
Jack Grigg <thestr4d@gmail.com>