.\" Generated by kramdown-man 1.0.1
.\" https://github.com/postmodern/kramdown-man#readme
.TH ronin-encrypt 1 "2023-02-01" Ronin "User Manuals"
.SH NAME
.PP
ronin\-encrypt \- Encrypts data
.SH SYNOPSIS
.PP
\fBronin encrypt\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIFILE\fP \.\.\.\[rB]
.SH DESCRIPTION
.PP
Encrypts data\.
.SH ARGUMENTS
.TP
\fIFILE\fP
The optional file to read and encrypt\. If no \fIFILE\fP arguments are given,
input will be read from \fBstdin\fR\.
.SH OPTIONS
.TP
\fB\-k\fR, \fB\-\-key\fR \fISTRING\fP
The raw key string for the cipher\.
.TP
\fB\-K\fR, \fB\-\-key\-file\fR \fIFILE\fP
Reads the key string from the file\.
.TP
\fB\-c\fR, \fB\-\-cipher\fR \fINAME\fP
The cipher to encrypt with\. See \fB\-\-list\-ciphers\fR for a list of supported
ciphers\. Default to \fBaes\-256\-cbc\fR if not given\.
.TP
\fB\-P\fR, \fB\-\-password\fR \fIPASSWORD\fP
The password to encrypt with\.
.TP
\fB\-H\fR, \fB\-\-hash\fR \fBmd5\fR\[or]\fBsha1\fR\[or]\fBsha256\fR\[or]\fBsha512\fR
The hash algorithm to use for the password\. Default to \fBsha256\fR if not given\.
.TP
\fB\-\-iv\fR \fISTRING\fP
Sets the Initial Vector (IV) value of the cipher\.
.TP
\fB\-\-padding\fR \fINUM\fP
Sets the padding size, in bytes, of the encryption cipher\.
.TP
\fB\-b\fR, \fB\-\-block\-size\fR \fINUM\fP
The size, in bytes, to read data in\. Default to \fB16384\fR if not given\.
.TP
\fB\-\-list\-ciphers\fR
List the supported ciphers and exits\.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help information\.
.SH EXAMPLES
.PP
Encrypt a file using AES\-256 (CBC mode) with a password:
.PP
.RS 4
.EX
\[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-password \[dq]\.\.\.\[dq] file\.txt > encrypted\.bin
.EE
.RE
.PP
Encrypt a file using a raw key string:
.PP
.RS 4
.EX
\[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]12345abcdef\.\.\.\[dq] file\.txt > encrypted\.bin
.EE
.RE
.PP
Encrypt a file using a raw key read from a file:
.PP
.RS 4
.EX
\[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key\-file key\.bin file\.txt > encrypted\.bin
.EE
.RE
.PP
Specifying a custom IV (initialization vector):
.PP
.RS 4
.EX
\[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]\.\.\.\[dq] \-\-iv \[dq]\.\.\.\[dq] file\.txt > encrypted\.bin
.EE
.RE
.SH AUTHOR
.PP
Postmodern 
.MT postmodern\.mod3\[at]gmail\.com
.ME
.SH SEE ALSO
.PP
.BR ronin\-decrypt (1)