mirror of
https://codeberg.org/scip/pcp.git
synced 2025-12-16 19:40:57 +01:00
re-generated
This commit is contained in:
15
README
15
README
@@ -111,7 +111,20 @@ INSTALLATION
|
|||||||
sudo ldconfig
|
sudo ldconfig
|
||||||
cd ..
|
cd ..
|
||||||
|
|
||||||
Next, pcp:
|
If you want to have JSON support, you'll need to install the Jansson
|
||||||
|
library (optional):
|
||||||
|
|
||||||
|
git clone git://github.com/akheron/jansson.git
|
||||||
|
cd jansson
|
||||||
|
autoreconf -i
|
||||||
|
./configure && make
|
||||||
|
sudo make install
|
||||||
|
cd ..
|
||||||
|
|
||||||
|
In order to use the python binding, you need to install the cffi python
|
||||||
|
package.
|
||||||
|
|
||||||
|
Next, build pcp:
|
||||||
|
|
||||||
git clone git://github.com/tlinden/pcp.git
|
git clone git://github.com/tlinden/pcp.git
|
||||||
cd pcp
|
cd pcp
|
||||||
|
|||||||
@@ -163,7 +163,7 @@ To learn how to use B<pcp>, read the manpage:
|
|||||||
|
|
||||||
=head1 COPYRIGHT
|
=head1 COPYRIGHT
|
||||||
|
|
||||||
Copyright (c) 2013-2016 by T.v.Dein <tom AT vondein DOT org>
|
Copyright (c) 2013-2015 by T.v.Dein <tom AT vondein DOT org>
|
||||||
|
|
||||||
=head1 ADDITIONAL COPYRIGHTS
|
=head1 ADDITIONAL COPYRIGHTS
|
||||||
|
|
||||||
|
|||||||
@@ -749,43 +749,43 @@ int pcp_readpass_fromprog(PCPCTX *ptx, char **passwd, const char *askpass);
|
|||||||
/*** ./gencffi.pl: from ../../include/pcp/scrypt.h:42 */
|
/*** ./gencffi.pl: from ../../include/pcp/scrypt.h:42 */
|
||||||
byte * pcp_scrypt(PCPCTX *ptx, char *passwd, size_t passwdlen, byte *nonce, size_t noncelen);
|
byte * pcp_scrypt(PCPCTX *ptx, char *passwd, size_t passwdlen, byte *nonce, size_t noncelen);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
char *_lc(char *in);
|
char *_lc(char *in);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
long int _findoffset(byte *bin, size_t binlen, char *sigstart, size_t hlen);
|
long int _findoffset(byte *bin, size_t binlen, char *sigstart, size_t hlen);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
void _xorbuf(byte *iv, byte *buf, size_t xlen);
|
void _xorbuf(byte *iv, byte *buf, size_t xlen);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
void _dump(char *n, byte *d, size_t s);
|
void _dump(char *n, byte *d, size_t s);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
char *_bin2hex(byte *bin, size_t len);
|
char *_bin2hex(byte *bin, size_t len);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
size_t _hex2bin(const char *hex_str, unsigned char *byte_array, size_t byte_array_max);
|
size_t _hex2bin(const char *hex_str, unsigned char *byte_array, size_t byte_array_max);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
int cst_time_memcmp(const void *m1, const void *m2, size_t n);
|
int cst_time_memcmp(const void *m1, const void *m2, size_t n);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
uint64_t _wireto64(byte *data);
|
uint64_t _wireto64(byte *data);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
uint32_t _wireto32(byte *data);
|
uint32_t _wireto32(byte *data);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
uint16_t _wireto16(byte *data);
|
uint16_t _wireto16(byte *data);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
void _64towire(uint64_t i, byte *data);
|
void _64towire(uint64_t i, byte *data);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
void _32towire(uint32_t i, byte *data);
|
void _32towire(uint32_t i, byte *data);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/util.h:141 */
|
/*** ./gencffi.pl: from ../../include/pcp/util.h:142 */
|
||||||
void _16towire(uint16_t i, byte *data);
|
void _16towire(uint16_t i, byte *data);
|
||||||
|
|
||||||
/*** ./gencffi.pl: from ../../include/pcp/vault.h:230 */
|
/*** ./gencffi.pl: from ../../include/pcp/vault.h:230 */
|
||||||
@@ -898,91 +898,7 @@ PCP_ASYM_CIPHER = 5
|
|||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
EXP_HASH_NAME = "BLAKE2"
|
PCP_BLOCK_SIZE = 32 * 1024
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_TYPE = 0x1F
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_CIPHER_NAME = "ED25519"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_ASYM_CIPHER_SIG = 24
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_RFC_CIPHER = 0x21
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_SYM_CIPHER = 23
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_ZFILE_HEADER = "----- BEGIN Z85 ENCODED FILE -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_SIG_START = "----- BEGIN ED25519 SIGNATURE -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_SUB_KEYEXPIRE = 9
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_VAULT_ID = 14
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SK_FOOTER = "----- END ED25519-CURVE29915 PRIVATE KEY -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_SIGPREFIX = "\nnacl-"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_PK_FOOTER = "----- END ED25519-CURVE29915 PUBLIC KEY -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_SUB_SIGEXPIRE = 3
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_SIG_END = "----- END ED25519 SIGNATURE -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_FORMAT_NATIVE = 1
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_ZFILE_FOOTER = "----- END Z85 ENCODED FILE -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_FORMAT_PBP = 2
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_PK_CIPHER = 0x21
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_SUB_KEYFLAGS = 27
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_SUB_CTIME = 2
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_HASH_CIPHER = 0x22
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
@@ -990,23 +906,7 @@ EXP_PK_HEADER = "----- BEGIN ED25519-CURVE29915 PUBLIC KEY -----"
|
|||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
PCP_ENFILE_FOOTER = "\r\n----- END PCP ENCRYPTED FILE -----\r\n"
|
EXP_SK_FOOTER = "----- END ED25519-CURVE29915 PRIVATE KEY -----"
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PCP_ASYM_CIPHER_ANON = 6
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SK_HEADER = "----- BEGIN ED25519-CURVE29915 PRIVATE KEY -----"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
PBP_COMPAT_SALT = "qa~t](84z<1t<1oz:ik.@IRNyhG=8q(on9}4#!/_h#a7wqK{Nt$T?W>,mt8NqYq&6U<GB1$,<$j>,rSYI2GRDd:Bcm"
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
|
||||||
EXP_SIG_CIPHER = 0x23
|
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
@@ -1014,24 +914,124 @@ PCP_ENFILE_HEADER = "----- BEGIN PCP ENCRYPTED FILE -----\r\n"
|
|||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
PCP_ME = "Pretty Curved Privacy"
|
EXP_FORMAT_NATIVE = 1
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
EXP_PK_CIPHER_NAME = "CURVE25519-ED25519-POLY1305-SALSA20"
|
PBP_COMPAT_SALT = "qa~t](84z<1t<1oz:ik.@IRNyhG=8q(on9}4#!/_h#a7wqK{Nt$T?W>,mt8NqYq&6U<GB1$,<$j>,rSYI2GRDd:Bcm"
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
PCP_BLOCK_SIZE = 32 * 1024
|
EXP_HASH_CIPHER = 0x22
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_HASH_NAME = "BLAKE2"
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
EXP_SIG_SUB_NOTATION = 20
|
EXP_SIG_SUB_NOTATION = 20
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_CIPHER_NAME = "ED25519"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_CIPHER = 0x23
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_ZFILE_HEADER = "----- BEGIN Z85 ENCODED FILE -----"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_SIG_END = "----- END ED25519 SIGNATURE -----"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_PK_CIPHER = 0x21
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_RFC_CIPHER = 0x21
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_ASYM_CIPHER_ANON = 6
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_ENFILE_FOOTER = "\r\n----- END PCP ENCRYPTED FILE -----\r\n"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_SYM_CIPHER = 23
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_TYPE = 0x1F
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_SUB_KEYFLAGS = 27
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SK_HEADER = "----- BEGIN ED25519-CURVE29915 PRIVATE KEY -----"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_SIGPREFIX = "\nnacl-"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_ME = "Pretty Curved Privacy"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_ZFILE_FOOTER = "----- END Z85 ENCODED FILE -----"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_SUB_SIGEXPIRE = 3
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_SUB_CTIME = 2
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_PK_FOOTER = "----- END ED25519-CURVE29915 PUBLIC KEY -----"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_VAULT_ID = 14
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
PCP_ASYM_CIPHER_ANON_SIG = 7
|
PCP_ASYM_CIPHER_ANON_SIG = 7
|
||||||
|
|
||||||
|
|
||||||
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
PCP_SIG_HEADER = "----- BEGIN ED25519 SIGNED MESSAGE -----"
|
PCP_SIG_HEADER = "----- BEGIN ED25519 SIGNED MESSAGE -----"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_ASYM_CIPHER_SIG = 24
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_PK_CIPHER_NAME = "CURVE25519-ED25519-POLY1305-SALSA20"
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_FORMAT_PBP = 2
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
EXP_SIG_SUB_KEYEXPIRE = 9
|
||||||
|
|
||||||
|
|
||||||
|
# ./gencffi.pl: from ../../include/pcp/defines.h:185
|
||||||
|
PCP_SIG_START = "----- BEGIN ED25519 SIGNATURE -----"
|
||||||
|
|||||||
@@ -7,7 +7,6 @@ extern "C" {
|
|||||||
|
|
||||||
#include "pcp/config.h"
|
#include "pcp/config.h"
|
||||||
#include "pcp/buffer.h"
|
#include "pcp/buffer.h"
|
||||||
#include "pcp/config.h"
|
|
||||||
#include "pcp/context.h"
|
#include "pcp/context.h"
|
||||||
#include "pcp/crypto.h"
|
#include "pcp/crypto.h"
|
||||||
#include "pcp/defines.h"
|
#include "pcp/defines.h"
|
||||||
|
|||||||
83
man/pcp1.1
83
man/pcp1.1
@@ -1,4 +1,4 @@
|
|||||||
.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
|
.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
|
||||||
.\"
|
.\"
|
||||||
.\" Standard preamble:
|
.\" Standard preamble:
|
||||||
.\" ========================================================================
|
.\" ========================================================================
|
||||||
@@ -38,8 +38,6 @@
|
|||||||
. ds PI \(*p
|
. ds PI \(*p
|
||||||
. ds L" ``
|
. ds L" ``
|
||||||
. ds R" ''
|
. ds R" ''
|
||||||
. ds C`
|
|
||||||
. ds C'
|
|
||||||
'br\}
|
'br\}
|
||||||
.\"
|
.\"
|
||||||
.\" Escape single quotes in literal strings from groff's Unicode transform.
|
.\" Escape single quotes in literal strings from groff's Unicode transform.
|
||||||
@@ -50,24 +48,17 @@
|
|||||||
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
||||||
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
||||||
.\" output yourself in some meaningful fashion.
|
.\" output yourself in some meaningful fashion.
|
||||||
.\"
|
.ie \nF \{\
|
||||||
.\" Avoid warning from groff about undefined register 'F'.
|
. de IX
|
||||||
.de IX
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||||
|
..
|
||||||
|
. nr % 0
|
||||||
|
. rr F
|
||||||
|
.\}
|
||||||
|
.el \{\
|
||||||
|
. de IX
|
||||||
..
|
..
|
||||||
.nr rF 0
|
|
||||||
.if \n(.g .if rF .nr rF 1
|
|
||||||
.if (\n(rF:(\n(.g==0)) \{
|
|
||||||
. if \nF \{
|
|
||||||
. de IX
|
|
||||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
|
||||||
..
|
|
||||||
. if !\nF==2 \{
|
|
||||||
. nr % 0
|
|
||||||
. nr F 2
|
|
||||||
. \}
|
|
||||||
. \}
|
|
||||||
.\}
|
.\}
|
||||||
.rr rF
|
|
||||||
.\"
|
.\"
|
||||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||||
@@ -133,7 +124,7 @@
|
|||||||
.\" ========================================================================
|
.\" ========================================================================
|
||||||
.\"
|
.\"
|
||||||
.IX Title "PCP1 1"
|
.IX Title "PCP1 1"
|
||||||
.TH PCP1 1 "2016-10-21" "PCP 0.4.0" "USER CONTRIBUTED DOCUMENTATION"
|
.TH PCP1 1 "2016-10-26" "PCP 0.4.0" "USER CONTRIBUTED DOCUMENTATION"
|
||||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||||
.\" way too many mistakes in technical documents.
|
.\" way too many mistakes in technical documents.
|
||||||
.if n .ad l
|
.if n .ad l
|
||||||
@@ -351,7 +342,7 @@ Pretty Curved Privacy \- File encryption using eliptic curve cryptography.
|
|||||||
be used to encrypt files. \fBpcp1\fR uses eliptc curve cryptography
|
be used to encrypt files. \fBpcp1\fR uses eliptc curve cryptography
|
||||||
for encryption (\s-1CURVE25519\s0 by Dan J. Bernstein). While \s-1CURVE25519\s0
|
for encryption (\s-1CURVE25519\s0 by Dan J. Bernstein). While \s-1CURVE25519\s0
|
||||||
is no worldwide accepted standard it hasn't been compromised by
|
is no worldwide accepted standard it hasn't been compromised by
|
||||||
the \s-1NSA \-\s0 which might be better, depending on your point of view.
|
the \s-1NSA\s0 \- which might be better, depending on your point of view.
|
||||||
.PP
|
.PP
|
||||||
\&\fBCaution\fR: since \s-1CURVE25519\s0 is no accepted standard, \fBpcp1\fR has
|
\&\fBCaution\fR: since \s-1CURVE25519\s0 is no accepted standard, \fBpcp1\fR has
|
||||||
to be considered as experimental software. In fact, I wrote it just
|
to be considered as experimental software. In fact, I wrote it just
|
||||||
@@ -677,10 +668,10 @@ Enable debugging output, where supported. Same as \fB\-D\fR.
|
|||||||
.IX Header "EXIT STATUS"
|
.IX Header "EXIT STATUS"
|
||||||
Pcp may return one of several error codes if it encounters problems.
|
Pcp may return one of several error codes if it encounters problems.
|
||||||
.IP "0 No problems occurred." 4
|
.IP "0 No problems occurred." 4
|
||||||
.IX Item "0 No problems occurred."
|
.IX Item "0 No problems occurred."
|
||||||
.PD 0
|
.PD 0
|
||||||
.IP "1 Generic error code." 4
|
.IP "1 Generic error code." 4
|
||||||
.IX Item "1 Generic error code."
|
.IX Item "1 Generic error code."
|
||||||
.PD
|
.PD
|
||||||
.SH "FILES"
|
.SH "FILES"
|
||||||
.IX Header "FILES"
|
.IX Header "FILES"
|
||||||
@@ -747,7 +738,7 @@ for the worst like passphrases like \*(L"aaa\*(R" or \*(L"x\*(R".
|
|||||||
.PP
|
.PP
|
||||||
Pcp considers passphrases with an entropy measurement of 3.32 or higher
|
Pcp considers passphrases with an entropy measurement of 3.32 or higher
|
||||||
as acceptable. This may change in the future.
|
as acceptable. This may change in the future.
|
||||||
.SS "\s-1VAULT FORMAT\s0"
|
.SS "\s-1VAULT\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "VAULT FORMAT"
|
.IX Subsection "VAULT FORMAT"
|
||||||
The vault file contains all public and secret keys. It's a portable
|
The vault file contains all public and secret keys. It's a portable
|
||||||
binary file.
|
binary file.
|
||||||
@@ -794,7 +785,7 @@ Type can be one of:
|
|||||||
.Ve
|
.Ve
|
||||||
.PP
|
.PP
|
||||||
The key header is followed by the actual key, see below.
|
The key header is followed by the actual key, see below.
|
||||||
.SS "\s-1SECRET KEY FORMAT\s0"
|
.SS "\s-1SECRET\s0 \s-1KEY\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "SECRET KEY FORMAT"
|
.IX Subsection "SECRET KEY FORMAT"
|
||||||
A secret key is a binary structure with the following format:
|
A secret key is a binary structure with the following format:
|
||||||
.PP
|
.PP
|
||||||
@@ -863,7 +854,7 @@ are otherwise unrelated. If one of them leaks, the other
|
|||||||
cannot be recalculated from it.
|
cannot be recalculated from it.
|
||||||
.PP
|
.PP
|
||||||
Take a look at the function \fB\f(BIpcp_keypairs()\fB\fR for details.
|
Take a look at the function \fB\f(BIpcp_keypairs()\fB\fR for details.
|
||||||
.SS "\s-1PUBLIC KEY EXPORT FORMAT\s0"
|
.SS "\s-1PUBLIC\s0 \s-1KEY\s0 \s-1EXPORT\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "PUBLIC KEY EXPORT FORMAT"
|
.IX Subsection "PUBLIC KEY EXPORT FORMAT"
|
||||||
Exported public and secret keys will be written in a portable
|
Exported public and secret keys will be written in a portable
|
||||||
way. Pcp uses \s-1RFC4880\s0 export format for public keys with some
|
way. Pcp uses \s-1RFC4880\s0 export format for public keys with some
|
||||||
@@ -967,7 +958,7 @@ So, a full pubkey export looks like this
|
|||||||
\& hash
|
\& hash
|
||||||
\& signature
|
\& signature
|
||||||
.Ve
|
.Ve
|
||||||
.SS "\s-1SECRET KEY EXPORT FORMAT\s0"
|
.SS "\s-1SECRET\s0 \s-1KEY\s0 \s-1EXPORT\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "SECRET KEY EXPORT FORMAT"
|
.IX Subsection "SECRET KEY EXPORT FORMAT"
|
||||||
Secret keys are exported in a proprietary format.
|
Secret keys are exported in a proprietary format.
|
||||||
.PP
|
.PP
|
||||||
@@ -999,7 +990,7 @@ to encrypt the data and looks after encryption as such:
|
|||||||
.Vb 1
|
.Vb 1
|
||||||
\& Nonce | Cipher
|
\& Nonce | Cipher
|
||||||
.Ve
|
.Ve
|
||||||
.SS "\s-1ENCRYPTED OUTPUT FORMAT\s0"
|
.SS "\s-1ENCRYPTED\s0 \s-1OUTPUT\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "ENCRYPTED OUTPUT FORMAT"
|
.IX Subsection "ENCRYPTED OUTPUT FORMAT"
|
||||||
The encryption protocol used by \s-1PCP\s0 uses mostly standard
|
The encryption protocol used by \s-1PCP\s0 uses mostly standard
|
||||||
libsodium facilities with the exception that \s-1PCP\s0 uses counter
|
libsodium facilities with the exception that \s-1PCP\s0 uses counter
|
||||||
@@ -1092,7 +1083,7 @@ of the sender.
|
|||||||
The encrypted output maybe Z85 encoded. In this case the Z85
|
The encrypted output maybe Z85 encoded. In this case the Z85
|
||||||
encoding will be done blockwise with blocks of 16k bytes. The
|
encoding will be done blockwise with blocks of 16k bytes. The
|
||||||
decoded content inside will be as described above.
|
decoded content inside will be as described above.
|
||||||
.SS "\s-1SIGNATURE FORMAT\s0"
|
.SS "\s-1SIGNATURE\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "SIGNATURE FORMAT"
|
.IX Subsection "SIGNATURE FORMAT"
|
||||||
There are different signature formats. Standard binary \s-1NACL\s0
|
There are different signature formats. Standard binary \s-1NACL\s0
|
||||||
signatures have the following format:
|
signatures have the following format:
|
||||||
@@ -1144,15 +1135,15 @@ Armored signatures have the following format:
|
|||||||
.PP
|
.PP
|
||||||
The Z85 encoded signature at the end contains the same signature
|
The Z85 encoded signature at the end contains the same signature
|
||||||
contents as the binary signature outlined above (hash+sig).
|
contents as the binary signature outlined above (hash+sig).
|
||||||
.SS "\s-1SIGNED ENCRYPTION FORMAT\s0"
|
.SS "\s-1SIGNED\s0 \s-1ENCRYPTION\s0 \s-1FORMAT\s0"
|
||||||
.IX Subsection "SIGNED ENCRYPTION FORMAT"
|
.IX Subsection "SIGNED ENCRYPTION FORMAT"
|
||||||
Signed encrypted files are in binary form only. The first part is
|
Signed encrypted files are in binary form only. The first part is
|
||||||
the standard encrypted file as described in \fB\s-1ENCRYPTED OUTPUT FORMAT\s0\fR
|
the standard encrypted file as described in \fB\s-1ENCRYPTED\s0 \s-1OUTPUT\s0 \s-1FORMAT\s0\fR
|
||||||
followed by the binary encrypted signature described in \fB\s-1SIGNATURE FORMAT\s0\fR
|
followed by the binary encrypted signature described in \fB\s-1SIGNATURE\s0 \s-1FORMAT\s0\fR
|
||||||
without the offset separator.
|
without the offset separator.
|
||||||
.PP
|
.PP
|
||||||
However, not only the hash of the file content will be signed but the
|
However, not only the hash of the file content will be signed but the
|
||||||
recipient list described in \fB\s-1ENCRYPTED OUTPUT FORMAT\s0\fR as well. A
|
recipient list described in \fB\s-1ENCRYPTED\s0 \s-1OUTPUT\s0 \s-1FORMAT\s0\fR as well. A
|
||||||
valid recipient is therefore not able to re-encrypt the decrypted
|
valid recipient is therefore not able to re-encrypt the decrypted
|
||||||
message, append the original signature and send it to other recipients.
|
message, append the original signature and send it to other recipients.
|
||||||
The signature would not match since the recipient list differs and
|
The signature would not match since the recipient list differs and
|
||||||
@@ -1192,7 +1183,7 @@ Before encryption the signature format is:
|
|||||||
\& +\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
\& +\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
||||||
.Ve
|
.Ve
|
||||||
.PP
|
.PP
|
||||||
where R is: C(recipient)|C(recipient)... (see \fB\s-1ENCRYPTED OUTPUT FORMAT\s0\fR).
|
where R is: C(recipient)|C(recipient)... (see \fB\s-1ENCRYPTED\s0 \s-1OUTPUT\s0 \s-1FORMAT\s0\fR).
|
||||||
.PP
|
.PP
|
||||||
Pseudocode:
|
Pseudocode:
|
||||||
.PP
|
.PP
|
||||||
@@ -1259,9 +1250,9 @@ pcp1 \-z \-I file \-O file.z85
|
|||||||
Reverse the process:
|
Reverse the process:
|
||||||
.PP
|
.PP
|
||||||
pcp1 \-Z \-I file.z85 \-O file
|
pcp1 \-Z \-I file.z85 \-O file
|
||||||
.SS "\s-1PBP COMPATIBILITY\s0"
|
.SS "\s-1PBP\s0 \s-1COMPATIBILITY\s0"
|
||||||
.IX Subsection "PBP COMPATIBILITY"
|
.IX Subsection "PBP COMPATIBILITY"
|
||||||
\&\s-1PCP\s0 tries to be fully compatible with \s-1PBP \s0(https://github.com/stef/pbp). Encrypted
|
\&\s-1PCP\s0 tries to be fully compatible with \s-1PBP\s0 (https://github.com/stef/pbp). Encrypted
|
||||||
files and signatures \- at least their binary versions \- should be exchangable. However,
|
files and signatures \- at least their binary versions \- should be exchangable. However,
|
||||||
this is a work in progress and might not work under all circumstances. Also there's currently
|
this is a work in progress and might not work under all circumstances. Also there's currently
|
||||||
no shared key format between pbp and pcp. However, it is possible to export and
|
no shared key format between pbp and pcp. However, it is possible to export and
|
||||||
@@ -1285,8 +1276,8 @@ functions:
|
|||||||
.PD
|
.PD
|
||||||
.PP
|
.PP
|
||||||
\&\s-1JSON\s0 support can be used either with the commandline tool \fBpcp1\fR or programmatically
|
\&\s-1JSON\s0 support can be used either with the commandline tool \fBpcp1\fR or programmatically
|
||||||
using the C, \*(C+ or Python \s-1API.\s0
|
using the C, \*(C+ or Python \s-1API\s0.
|
||||||
.SS "\s-1USING JSON FROM THE C API\s0"
|
.SS "\s-1USING\s0 \s-1JSON\s0 \s-1FROM\s0 \s-1THE\s0 C \s-1API\s0"
|
||||||
.IX Subsection "USING JSON FROM THE C API"
|
.IX Subsection "USING JSON FROM THE C API"
|
||||||
In order to use \s-1JSON\s0 all you've got to do is to switch a context flag:
|
In order to use \s-1JSON\s0 all you've got to do is to switch a context flag:
|
||||||
.PP
|
.PP
|
||||||
@@ -1296,9 +1287,9 @@ In order to use \s-1JSON\s0 all you've got to do is to switch a context flag:
|
|||||||
.Ve
|
.Ve
|
||||||
.PP
|
.PP
|
||||||
That all to it. Now any function normally used for key import and export works
|
That all to it. Now any function normally used for key import and export works
|
||||||
with \s-1JSON,\s0 just fill the \fBBuffer\fR object with a \s-1JSON\s0 string for imports or
|
with \s-1JSON\s0, just fill the \fBBuffer\fR object with a \s-1JSON\s0 string for imports or
|
||||||
fetch the Buffer content of an export function as a string.
|
fetch the Buffer content of an export function as a string.
|
||||||
.SS "\s-1USING JSON FROM THE COMMANDLINE\s0"
|
.SS "\s-1USING\s0 \s-1JSON\s0 \s-1FROM\s0 \s-1THE\s0 \s-1COMMANDLINE\s0"
|
||||||
.IX Subsection "USING JSON FROM THE COMMANDLINE"
|
.IX Subsection "USING JSON FROM THE COMMANDLINE"
|
||||||
In order to use \s-1JSON\s0 on the commandline, add \fB\-j\fR. This can be used in
|
In order to use \s-1JSON\s0 on the commandline, add \fB\-j\fR. This can be used in
|
||||||
conjunction with the following options:
|
conjunction with the following options:
|
||||||
@@ -1316,9 +1307,9 @@ Public and secret key import.
|
|||||||
Text view mode (aka inspect mode).
|
Text view mode (aka inspect mode).
|
||||||
.PP
|
.PP
|
||||||
The \fB\-z\fR and \fB\-Z\fR options are ignored in \s-1JSON\s0 mode.
|
The \fB\-z\fR and \fB\-Z\fR options are ignored in \s-1JSON\s0 mode.
|
||||||
.SS "\s-1JSON OBJECT STRUCTURE\s0"
|
.SS "\s-1JSON\s0 \s-1OBJECT\s0 \s-1STRUCTURE\s0"
|
||||||
.IX Subsection "JSON OBJECT STRUCTURE"
|
.IX Subsection "JSON OBJECT STRUCTURE"
|
||||||
\fI\s-1JSON PUBLIC KEY \s0(pcp1 \-p \-j)\fR
|
\fI\s-1JSON\s0 \s-1PUBLIC\s0 \s-1KEY\s0 (pcp1 \-p \-j)\fR
|
||||||
.IX Subsection "JSON PUBLIC KEY (pcp1 -p -j)"
|
.IX Subsection "JSON PUBLIC KEY (pcp1 -p -j)"
|
||||||
.PP
|
.PP
|
||||||
The \s-1JSON\s0 object for a public key looks like this:
|
The \s-1JSON\s0 object for a public key looks like this:
|
||||||
@@ -1347,7 +1338,7 @@ Fields containing byte arrays are hex encoded.
|
|||||||
.PP
|
.PP
|
||||||
Numbers are represented as literal integers.
|
Numbers are represented as literal integers.
|
||||||
.PP
|
.PP
|
||||||
\fI\s-1JSON SECRET KEY \s0(pcp1 \-s \-j)\fR
|
\fI\s-1JSON\s0 \s-1SECRET\s0 \s-1KEY\s0 (pcp1 \-s \-j)\fR
|
||||||
.IX Subsection "JSON SECRET KEY (pcp1 -s -j)"
|
.IX Subsection "JSON SECRET KEY (pcp1 -s -j)"
|
||||||
.PP
|
.PP
|
||||||
The \s-1JSON\s0 object for a public key looks like this:
|
The \s-1JSON\s0 object for a public key looks like this:
|
||||||
@@ -1378,7 +1369,7 @@ secret key material. Pcp does not support exporting a secret key unencrypted.
|
|||||||
The \fBnonce\fR is required for a later import and shall not be changed or
|
The \fBnonce\fR is required for a later import and shall not be changed or
|
||||||
decoupled from \fBsecrets\fR. This may change in the future.
|
decoupled from \fBsecrets\fR. This may change in the future.
|
||||||
.PP
|
.PP
|
||||||
\fI\s-1JSON VAULT \s0(pcp1 \-t)\fR
|
\fI\s-1JSON\s0 \s-1VAULT\s0 (pcp1 \-t)\fR
|
||||||
.IX Subsection "JSON VAULT (pcp1 -t)"
|
.IX Subsection "JSON VAULT (pcp1 -t)"
|
||||||
.PP
|
.PP
|
||||||
The \s-1JSON\s0 object for the vault looks like this:
|
The \s-1JSON\s0 object for the vault looks like this:
|
||||||
@@ -1397,7 +1388,7 @@ The \s-1JSON\s0 object for the vault looks like this:
|
|||||||
The field \fBkeys\fR is an array containing one or more of the already
|
The field \fBkeys\fR is an array containing one or more of the already
|
||||||
described key objects.
|
described key objects.
|
||||||
.PP
|
.PP
|
||||||
\fI\s-1JSON PROGRAM OUTPUT\s0\fR
|
\fI\s-1JSON\s0 \s-1PROGRAM\s0 \s-1OUTPUT\s0\fR
|
||||||
.IX Subsection "JSON PROGRAM OUTPUT"
|
.IX Subsection "JSON PROGRAM OUTPUT"
|
||||||
.PP
|
.PP
|
||||||
Currently pcp does not support \s-1JSON\s0 program output, that is, success or
|
Currently pcp does not support \s-1JSON\s0 program output, that is, success or
|
||||||
@@ -1446,7 +1437,7 @@ under the \fB\s-1GPL\s0\fR as well.
|
|||||||
\&\fIT.v.Dein <tom \s-1AT\s0 vondein \s-1DOT\s0 org\fR>
|
\&\fIT.v.Dein <tom \s-1AT\s0 vondein \s-1DOT\s0 org\fR>
|
||||||
.SH "LICENSE"
|
.SH "LICENSE"
|
||||||
.IX Header "LICENSE"
|
.IX Header "LICENSE"
|
||||||
Licensed under the \s-1GNU GENERAL PUBLIC LICENSE\s0 version 3.
|
Licensed under the \s-1GNU\s0 \s-1GENERAL\s0 \s-1PUBLIC\s0 \s-1LICENSE\s0 version 3.
|
||||||
.SH "HOME"
|
.SH "HOME"
|
||||||
.IX Header "HOME"
|
.IX Header "HOME"
|
||||||
The homepage of Pretty Curved Privacy can be found on
|
The homepage of Pretty Curved Privacy can be found on
|
||||||
|
|||||||
1575
man/pcp1.html
1575
man/pcp1.html
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user