From c17a016fb4c3d2594603803e859ac0f6792d19dd Mon Sep 17 00:00:00 2001 From: Lian Drake Date: Sun, 20 Oct 2024 23:23:32 -0400 Subject: [PATCH] Updated Makefile and added manpage --- Makefile | 19 +++++++++++++------ passgen.1 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 61 insertions(+), 6 deletions(-) create mode 100644 passgen.1 diff --git a/Makefile b/Makefile index e613fcf..722d165 100644 --- a/Makefile +++ b/Makefile @@ -1,17 +1,24 @@ -all: passgen - +PREFIX ?= /usr/local WARNINGS = -Wall DEBUG = -ggdb -fno-omit-frame-pointer OPTIMIZE = -O2 +all: passgen + passgen: Makefile passgen.c - $(CC) -o $@ $(WARNINGS) $(DEBUG) $(OPTIMIZE) passgen.c + $(CC) -o $@ $(WARNINGS) $(DEBUG) $(OPTIMIZE) passgen.c clean: - rm -f passgen + rm -f passgen install: - echo "Installing is not supported" + install -Dm755 passgen $(DESTDIR)$(PREFIX)/bin/passgen + install -Dm644 passgen.1 $(DESTDIR)$(PREFIX)/share/man/man1/passgen.1 + +uninstall: + rm -f $(DESTDIR)$(PREFIX)/bin/passgen + rm -f $(DESTDIR)$(PREFIX)/share/man/man1/passgen.1 run: - ./passgen + ./passgen + diff --git a/passgen.1 b/passgen.1 new file mode 100644 index 0000000..2fce296 --- /dev/null +++ b/passgen.1 @@ -0,0 +1,48 @@ +.TH PASSGEN 1 "October 2024" "v0.1" "Passgen Manual" +.SH NAME +passgen \- Generate passwords with ease +.SH SYNOPSIS +.B passgen +[\fIOPTIONS\fR] +.SH DESCRIPTION +.B passgen +is a command-line utility for generating random passwords with customizable options such as the length of the password and inclusion of upper-case letters, lower-case letters, digits, and special characters. + +If no options are provided, a default 24-character password containing all character types is generated. + +.SH OPTIONS +.TP +.BR -L ", " --length=\fILENGTH\fR +Specify the length of the generated password. The length must be between 5 and 4096 characters. The default is 24 characters. +.TP +.BR -l ", " --lower-case +Include lowercase letters in the password. +.TP +.BR -u ", " --upper-case +Include uppercase letters in the password. +.TP +.BR -d ", " --digits +Include digits (0-9) in the password. +.TP +.BR -s ", " --special +Include special characters in the password. +.TP +.BR -h ", " --help +Display this help message and exit. +.TP +.BR -v ", " --version +Display version information and exit. + +.SH EXAMPLES +.B passgen +.br +Generates a 24-character password using all character types. + +.B passgen \-L 16 \-l \-u +.br +Generates a 16-character password with lowercase and uppercase letters. + +.SH AUTHOR +Clay Gomera +.SH LICENSE +This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.