Adding upstream version 0.11.0.
Alf Gaida
7 years ago
| 0 | ||
| 1 | lxqt-openssh-askpass-0.11.0 / 2016-09-24 | |
| 2 | ======================================== | |
| 3 | ||
| 4 | * Rework README.md | |
| 5 | * build: Use external translations | |
| 6 | * ts-files removal (#19) | |
| 7 | * Fix typo in German translation (#18) | |
| 8 | * Bump year Fix licenses, lxqt-openssh-askpass is LGPL only | |
| 9 | * Italian translation update | |
| 10 | * Fix target language in translation file template | |
| 11 | * Remove ru_RU translation file | |
| 12 | * new: lxqt-openssh-askpass_hu.ts | |
| 13 | ||
| 14 | 0.10.0 / 2015-10-31 | |
| 15 | =================== | |
| 16 | ||
| 17 | * Update translations | |
| 18 | * Improve README | |
| 19 | * Fix license file | |
| 20 | * Fix typos in man page | |
| 21 | * Add Greek (el) translation | |
| 22 | * Rename LxQt to LXQt everywhere | |
| 23 | * Fix typos | |
| 24 | * Handles CMake policy CMP0063 | |
| 25 | * Use the LXQtCompilerSettings CMake module | |
| 26 | * Adds Runtime COMPONENT | |
| 27 | * Coding style changes | |
| 28 | * Use GNUInstallDirs | |
| 29 | * Use CMAKE_AUTOUIC, drop qt5_wrap_ui() | |
| 30 | * Use CMAKE_AUTOMOC, drop qt5_wrap_cpp() | |
| 31 | * Removes unneeded entries from include_directories() | |
| 32 | * Updates the build system to use the Targets infrastructure | |
| 33 | * Fix naming and links | |
| 34 | ||
| 35 | 0.9.0 / 2015-01-25 | |
| 36 | ================== | |
| 37 | ||
| 38 | * Added german translation. | |
| 39 | * File name was ok but language name wasn´t. My mistake. | |
| 40 | * Makes translation filename match language="pt_PT" | |
| 41 | * Portuguese update | |
| 42 | * - Unify naming for a unique lxqt. No more suffixes | |
| 43 | * CMakeLists.txt maintenance. | |
| 44 | * Pass the UPDATE_TRANSLATIONS value to lxqt_translate_ts() | |
| 45 | * Renames translations sources template from .ts.src to .ts | |
| 46 | * Don't update (extract) translations by default. | |
| 47 | * Handle translations | |
| 48 | * Add Russian translation | |
| 49 | * Clean up CMakeLists.txt and drop Qt 4 | |
| 50 | ||
| 51 | 0.8.0 / 2014-07-01 | |
| 52 | ================== | |
| 53 | ||
| 54 | * Qt4/Qt5 switching fixed booth Qt4 and Qt5 build now without errors | |
| 55 | * Add Qt5 support. | |
| 56 | * Use new LXQt header files. | |
| 57 | ||
| 58 | 0.7.0 / 2014-05-01 | |
| 59 | ================== | |
| 60 | ||
| 61 | * Update AUTHORS and COPYING files | |
| 62 | * Add CPack rules for creating tarball | |
| 63 | * Fix renaming bugs, replacing lxqt-qt with lxde-qt | |
| 64 | * Finish the crazy razor=>lxqt renaming tasks. | |
| 65 | * Fix broken build and use liblxqt instead. * Rename binary to lxqt-openssh-askpass. | |
| 66 | * Add COPYING and AUTHORS | |
| 67 | * preliminary manpages primary for razorqt and usefully in venenux | |
| 68 | * Remove stray code | |
| 69 | * Generate translation files | |
| 70 | * Fix components missing translations | |
| 71 | * openssh-askpass: stay on top; don't hide under windows | |
| 72 | * Small fixes (typo and a wrong parameter) | |
| 73 | * new module "ssh-askpass helper" |
| 0 | 0 | # lxqt-openssh-askpass |
| 1 | 1 | |
| 2 | This is a very small helper app for ssh-agent. | |
| 2 | ## Overview | |
| 3 | 3 | |
| 4 | Example setup: | |
| 4 | `lxqt-openssh-askpass` is a GUI to query credentials on behalf of other programs. As indicated by its name it's primarily targeted at `ssh-agent`, the SSH agent of OpenSSH, but it works with other applications like e. g. EncFS as well. | |
| 5 | 5 | |
| 6 | - Run the lxqt-config-session. | |
| 7 | - Add new item into the "Environment (Advanced)": `SSH_ASKPASS=lxqt-openssh-askpass` | |
| 8 | - If you want to register your keys on session startup add new item to "Autostart" tab. For example: | |
| 9 | - name: ssh-add | |
| 10 | - command: ssh-add | |
| 11 | - wait for system tray: false | |
| 12 | - logout/login/enjoy | |
| 6 | It was considered to abandon the tool in favour of KDE's `ksshaskpass` and lxqt-openssh-askpass had temporarily been declared deprecated for this reason. But it turned out the close bond of `ksshaskpass` to KWallet conflicts with LXQt's design goals so it's all but certain the replacement will happen. See https://github.com/lxde/lxqt/issues/362. | |
| 7 | ||
| 8 | ## Installation | |
| 9 | ||
| 10 | ### Compiling source code | |
| 11 | ||
| 12 | The only runtime dependency is [liblxqt](https://github.com/lxde/liblxqt). | |
| 13 | Additional build dependencies are CMake and optionally Git to pull latest VCS checkouts. The localization files were outsourced to repository [lxqt-l10n](https://github.com/lxde/lxqt-l10n) so the corresponding dependencies are needed, too. Please refer to this repository's `README.md` for further information. | |
| 14 | ||
| 15 | Code configuration is handled by CMake. CMake variable `CMAKE_INSTALL_PREFIX` has to be set to `/usr` on most operating systems. | |
| 16 | ||
| 17 | To build run `make`, to install `make install` which accepts variable `DESTDIR` as usual. | |
| 18 | ||
| 19 | ### Binary packages | |
| 20 | ||
| 21 | Official binary packages are provided by all major Linux distributions like Arch Linux, Debian (as of Debian stretch only), Fedora and openSUSE. Just use your package manager to search for string `lxqt-openssh-askpass`. | |
| 22 | ||
| 23 | ## Configuration, Usage | |
| 24 | ||
| 25 | ### ssh-agent | |
| 26 | ||
| 27 | First of all it must be ensured `ssh-agent` is running in LXQt sessions. This is basically beyond this document's scope but can e. g. be achieved by a user systemd unit | |
| 28 | ``` | |
| 29 | [Unit] | |
| 30 | Description=Some arbitrary description | |
| 31 | ||
| 32 | [Service] | |
| 33 | Type=forking | |
| 34 | ExecStart=/usr/bin/ssh-agent -a /run/user/<ID>/ssh-agent | |
| 35 | ||
| 36 | [Install] | |
| 37 | WantedBy=default.target | |
| 38 | ``` | |
| 39 | where ID corresponds with the respective user's UID as displayed by `$ id <user>`. | |
| 40 | ||
| 41 | Environment variable `SSH_AUTH_SOCK` must point to the socket of `ssh-agent` as e. g. stated by option `-a` in the systemd unit depicted above. Environment variable `SSH_ASKPASS` must be set to `lxqt-openssh-askpass` to indicate this binary should be used. | |
| 42 | Both variables can be set in section "Environment (Advanced)" of configuration dialogue [LXQt Session Settings](https://github.com/lxde/lxqt-session#lxqt-session-settings) of [lxqt-session](https://github.com/lxde/lxqt-session). Changes apply upon the next login only. | |
| 43 | ||
| 44 | Note binary `ssh-add` which is used to register keys with `ssh-agent` will use GUI tools like `lxqt-openssh-askpass` only when it is *not* attached to a terminal. | |
| 45 | So `lxqt-openssh-askpass` will not be used when `ssh-add` is launched from a terminal emulator like QTerminal even when everything is configured as stated above. `lxqt-openssh-askpass` will be used when the invocation of `ssh-add` is handled by an autostart entry which can be configured in section "Autostart" of "LXQt Session Settings" or when a desktop entry file is used to invoke the tool from menus. | |
| 46 | ||
| 47 | ### EncFS | |
| 48 | ||
| 49 | Simply hand `lxqt-openssh` to binary `encfs` by option `--extpass`, like in `encfs --extpass=lxqt-openssh-askpass <rootdir> <mount point>`. | |
| 50 | In contrast to `ssh-{agent,add}` this works when `encfs` is launched from a terminal emulator, too. |