guido+pwm@1: pwm guido+pwm@1: === guido+pwm@1: guido+pwm@1: Description guido+pwm@1: ----------- guido+pwm@1: guido+pwm@1: The pwm utility is a password manager which stores passwords and associated guido+pwm@1: metadata in an encrypted database protected by a master password. It has a guido+pwm@1: text-based user interface and can be used both interactively and guido+pwm@1: non-interactively. The database uses the PasswordSafe database format guido+pwm@1: version 3 and is thus compatible with other password managers using this guido+pwm@1: format. guido+pwm@1: guido+pwm@1: Build Instructions guido+pwm@1: ------------------ guido+pwm@1: guido+pwm@1: pwm requires a POSIX:2004 compatible operating system, it has been tested to guido+pwm@1: work on Linux distributions, FreeBSD, NetBSD, OpenBSD, Solaris and guido+pwm@1: Illumos-derived distributions. The following tools and shared libraries are guido+pwm@1: required to build pwm: guido+pwm@1: guido+pwm@1: - GNU make >= 3.81 guido+pwm@1: - GNU or BSD install guido+pwm@1: - libtecla >= 1.6.0 guido+pwm@1: - libpws >= 1.0.0 guido+pwm@1: guido+pwm@1: Rebuilding the man pages additionally requires the xsltproc tool from libxml2. guido+pwm@1: guido+pwm@1: Before building pwm check the commented macros in the Makefile for any guido+pwm@1: macros you may need to override depending on the used toolchain and operating guido+pwm@1: system. guido+pwm@1: guido+pwm@1: By default, all files will be installed under the "/usr/local" directory, a guido+pwm@1: different installation path prefix can be set via the `prefix` macro. In guido+pwm@1: addition, a second path prefix can be specified via the `DESTDIR` macro which guido+pwm@1: will be prepended to any path, incuding the `prefix` macro path prefix. In guido+pwm@1: contrast to `prefix`, the path specified via the `DESTDIR` macro will only be guido+pwm@1: prepended to paths during installation and not be used for constructing guido+pwm@1: internal paths. guido+pwm@1: guido+pwm@1: The following instructions assume that `make` is GNU make, on some platforms guido+pwm@1: it may be installed under a different name or a non-default path. In order to guido+pwm@1: start the build process run `make all`. After a successful build, run `make guido+pwm@1: install` to install the program, any associated data files and the guido+pwm@1: documentation. guido+pwm@1: guido+pwm@1: Previously built binaries, object files, generated data files and guido+pwm@1: documentation can be removed by running `make clean`, any additional, guido+pwm@1: generated files which are not removed by the `clean` target can be removed by guido+pwm@1: running `make clobber`. guido+pwm@1: guido+pwm@1: Contact guido+pwm@1: ------- guido+pwm@1: guido+pwm@1: Please send any feedback, translations or bug reports via email to guido+pwm@1: . guido+pwm@1: guido+pwm@1: Bug Reports guido+pwm@1: ----------- guido+pwm@1: guido+pwm@1: When sending bug reports, please always mention the exact version of pwm guido+pwm@1: with which the issue occurs as well as the version of the operating system you guido+pwm@1: are using and make sure that you provide sufficient information to reproduce guido+pwm@1: the issue and include any input, output, any error messages. guido+pwm@1: guido+pwm@1: In case of build issues, please also specify the implementations and versions guido+pwm@1: of the tools and shared libraries used to build the program, in particular the guido+pwm@1: compiler. guido+pwm@1: guido+pwm@1: In case of crashes, please generate a stack trace with a suitable debugger guido+pwm@1: such as gdb, lldb, dbx, or debug after a crash has occurred either by guido+pwm@1: examining the resulting core file or by running the program from the debugger guido+pwm@1: and attach it to the bug report. In order to generate a meaningful stack guido+pwm@1: trace the program as well as any dynamically linked libraries need to be built guido+pwm@1: with debugging information, see the documentation of the used compiler for the guido+pwm@1: required compiler flags. If any of the dynamically linked shared libraries do guido+pwm@1: not contain debugging information, please either install debugging information guido+pwm@1: for these libraries using mechanisms provided by your operating system or guido+pwm@1: rebuild the libraries accordingly. Please refer to the documentation of the guido+pwm@1: debugger for detailed instructions on generating backtraces. guido+pwm@1: guido+pwm@1: License guido+pwm@1: ------- guido+pwm@1: guido+pwm@1: Except otherwise noted, all files are Copyright (C) 2017 Guido Berhoerster and guido+pwm@1: distributed under the following license terms: guido+pwm@1: guido+pwm@1: Copyright (C) 2017 Guido Berhoerster guido+pwm@1: guido+pwm@1: Permission is hereby granted, free of charge, to any person obtaining guido+pwm@1: a copy of this software and associated documentation files (the guido+pwm@1: "Software"), to deal in the Software without restriction, including guido+pwm@1: without limitation the rights to use, copy, modify, merge, publish, guido+pwm@1: distribute, sublicense, and/or sell copies of the Software, and to guido+pwm@1: permit persons to whom the Software is furnished to do so, subject to guido+pwm@1: the following conditions: guido+pwm@1: guido+pwm@1: The above copyright notice and this permission notice shall be included guido+pwm@1: in all copies or substantial portions of the Software. guido+pwm@1: guido+pwm@1: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, guido+pwm@1: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF guido+pwm@1: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. guido+pwm@1: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY guido+pwm@1: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, guido+pwm@1: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE guido+pwm@1: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.