mirror of
https://github.com/FiloSottile/age.git
synced 2026-01-03 10:55:14 +00:00
57 lines
1.7 KiB
Groff
57 lines
1.7 KiB
Groff
.\" generated with Ronn-NG/v0.9.1
|
|
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
|
|
.TH "AGE\-KEYGEN" "1" "June 2024" ""
|
|
.SH "NAME"
|
|
\fBage\-keygen\fR \- generate age(1) key pairs
|
|
.SH "SYNOPSIS"
|
|
\fBage\-keygen\fR [\fB\-o\fR \fIOUTPUT\fR]
|
|
.br
|
|
\fBage\-keygen\fR \fB\-y\fR [\fB\-o\fR \fIOUTPUT\fR] [\fIINPUT\fR]
|
|
.br
|
|
.SH "DESCRIPTION"
|
|
\fBage\-keygen\fR generates a new native age(1) key pair, and outputs the identity to standard output or to the \fIOUTPUT\fR file\. The output includes the public key and the current time as comments\.
|
|
.P
|
|
If the output is not going to a terminal, \fBage\-keygen\fR prints the public key to standard error\.
|
|
.SH "OPTIONS"
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output\fR=\fIOUTPUT\fR
|
|
Write the identity to \fIOUTPUT\fR instead of standard output\.
|
|
.IP
|
|
If \fIOUTPUT\fR already exists, it is not overwritten\.
|
|
.TP
|
|
\fB\-y\fR
|
|
Read an identity file from \fIINPUT\fR or from standard input and output the corresponding recipient(s), one per line, with no comments\.
|
|
.TP
|
|
\fB\-\-version\fR
|
|
Print the version and exit\.
|
|
.SH "EXAMPLES"
|
|
Generate a new identity:
|
|
.IP "" 4
|
|
.nf
|
|
$ age\-keygen
|
|
# created: 2021\-01\-02T15:30:45+01:00
|
|
# public key: age1lvyvwawkr0mcnnnncaghunadrqkmuf9e6507x9y920xxpp866cnql7dp2z
|
|
AGE\-SECRET\-KEY\-1N9JEPW6DWJ0ZQUDX63F5A03GX8QUW7PXDE39N8UYF82VZ9PC8UFS3M7XA9
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
Write a new identity to \fBkey\.txt\fR:
|
|
.IP "" 4
|
|
.nf
|
|
$ age\-keygen \-o key\.txt
|
|
Public key: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
Convert an identity to a recipient:
|
|
.IP "" 4
|
|
.nf
|
|
$ age\-keygen \-y key\.txt
|
|
age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p
|
|
.fi
|
|
.IP "" 0
|
|
.SH "SEE ALSO"
|
|
age(1)
|
|
.SH "AUTHORS"
|
|
Filippo Valsorda \fIage@filippo\.io\fR
|