aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNicholas Tay <nick@windblume.net>2024-04-16 21:58:25 +1000
committerNicholas Tay <nick@windblume.net>2024-04-16 21:58:25 +1000
commite1ffb003677e6e73ca59517723866ff9133915df (patch)
tree53e6fe95f1249339b36d3138a2bf81cd6c3ac40c
parente6e6ab5f69c9669376d9ad649f300fb080c1a810 (diff)
downloadpassgen-e1ffb003677e6e73ca59517723866ff9133915df.tar.gz
passgen-e1ffb003677e6e73ca59517723866ff9133915df.tar.bz2
passgen-e1ffb003677e6e73ca59517723866ff9133915df.zip
Update readmeHEADmaster
-rw-r--r--LICENCE2
-rw-r--r--README.md24
2 files changed, 20 insertions, 6 deletions
diff --git a/LICENCE b/LICENCE
index 7bbf6b1..fed2242 100644
--- a/LICENCE
+++ b/LICENCE
@@ -1,4 +1,4 @@
-Copyright (c) 2021 Nicholas Tay <nick@windblume.net>
+Copyright (c) 2021-2024 Nicholas Tay <nick@windblume.net>
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
diff --git a/README.md b/README.md
index 30b651c..333b620 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
Just a password generator that makes [passwds.ninja](https://passwds.ninja/)-style passwords.
-Heavily inspired by a generator I used before at work (in Python), just that this time in C.
+Heavily inspired by a generator I used before at work (in Python), just that this time in C99.
As such, it utilises 'grammars' of character classes, which can be efficiently be mixed and matched on the fly, and/or the grammars themselves being able to be easily customised at compile-time.
@@ -12,7 +12,7 @@ See `passgen --help` for details.
## Install
-passgen is packaged for Fedora Linux and Homebrew.
+passgen is officially packaged for Fedora Linux and Homebrew, as these are the platforms I use.
```
# Fedora (COPR)
@@ -24,17 +24,31 @@ $ brew tap nicholastay/tap
$ brew install passgen
```
+As it is a fairly simple, portable C99 application, it should be easy enough to follow the steps below for the specific platform with just a standard C compiler.
+
## Compiling
```
-# *nix / macOS / mingw (on Windows)
+# *nix / macOS / Windows-MinGW
$ make
+# (optionally to install into prefix, default target is ~/.local/bin/)
+$ make install
-# Windows, in Developer CMD
+# Windows with MSVC, in MSVC Developer CMD
$ build_msvc.bat
+
+# Cross-compile for Win32 via MinGW on Linux
+$ make passgen.exe
+# (for Win64)
+$ make passgen.exe CC_WIN32=x86_64-w64-mingw32-gcc
+
+# Cross-compile for DOS 16-bit Real Mode via OpenWatcom on Linux
+$ export WATCOM=<path to watcom install>
+$ export PATH=$WATCOM/binl64:$WATCOM/binl:$PATH; export EDPATH=$WATCOM/eddat; export INCLUDE=$WATCOM/h
+$ make passgen.com
```
-NOTE: Compilation with mingw will use the fallback RNG for password generation. This utilises `rand()` in C, seeded with the time and PID - may be unsafe! On Windows with `cl`, \*nix, macOS, Free/OpenBSD, the relevant system calls will be utilised to get better quality randomness. See the `_rng` functions for details.
+NOTE: Compilation under certain modes will fallback to a weaker RNG source. This utilises `rand()` in C, seeded with the time and PID - may be quite insecure! A modern compiler should warn when compiled in this mode. On most modern systems (Windows XP+ with `cl`/`mingw`, \*nix, macOS, Free/OpenBSD), the relevant system calls will be utilised to get better quality randomness. See the `_rng` functions for details.
## Licence