summaryrefslogtreecommitdiff
path: root/fp2alias.1
blob: 8253bc9436e97da87d8e2488b9018a547e2457bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
.TH fp2alias 1

.SH NAME
fp2alias - a basic fingerprint-to-alias converter

.SH SYNOPSIS
fp2alias [\fIoption ...\fR] [--] [<\fIcommand\fR> [\fIargument ...\fR]]

.SH DESCRIPTION
fp2alias is a helper program for TLSd. It reads the \fBSHA256\fR
environment variable, adds the \fBALIAS\fR variable by looking it up
in a file, and runs a given command with that variable in the
environment.

If it's not allowed to add new aliases, it would reject unknown users.

.SH OPTIONS
.IP "\fB\-f\fR \fIfile\fR"
A file with "\fIfingerprint\fR \fIalias\fR" entries (default is
\fB/etc/tls/aliases\fR).
.IP \fB\-a\fR
Add new aliases.
.IP "\fB\-i\fR \fIident\fR"
Syslog identifier to use.
.IP \fB\-e\fR
Print messages into stderr, in addition to syslog.
.IP \fB\-h\fR
Print a help message and exit.

.SH EXAMPLES
.SS Echo server
.nf
tlsd -- fp2alias -- cat
.fi

.SS Authentication
.nf
tlsd -- fp2alias -- sh -c 'echo "Hello, ${ALIAS}!"'
.fi

.SH COPYING
This is free and unencumbered software released into the public
domain.

.SH SEE ALSO
\fBtlsd\fR(1)

See \fBinfo tlsd\fR for more documentation.