CVS commit: pkgsrc/security/keychain

["Paolo Vincenzo Olivo" <vins%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   vins
Date:           Sat Nov  8 19:13:40 UTC 2025

Modified Files:
        pkgsrc/security/keychain: Makefile PLIST
Added Files:
        pkgsrc/security/keychain/files: startkeychain.1
Removed Files:
        pkgsrc/security/keychain/files: README.pkgsrc

Log Message:
security/keychain: startkeychain: replace README with man page.


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 pkgsrc/security/keychain/Makefile
cvs rdiff -u -r1.8 -r1.9 pkgsrc/security/keychain/PLIST
cvs rdiff -u -r1.3 -r0 pkgsrc/security/keychain/files/README.pkgsrc
cvs rdiff -u -r0 -r1.1 pkgsrc/security/keychain/files/startkeychain.1

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/security/keychain/Makefile
diff -u pkgsrc/security/keychain/Makefile:1.48 pkgsrc/security/keychain/Makefile:1.49
--- pkgsrc/security/keychain/Makefile:1.48      Sat Nov  8 16:55:52 2025
+++ pkgsrc/security/keychain/Makefile   Sat Nov  8 19:13:40 2025
@@ -1,7 +1,7 @@
-# $NetBSD: Makefile,v 1.48 2025/11/08 16:55:52 vins Exp $
+# $NetBSD: Makefile,v 1.49 2025/11/08 19:13:40 vins Exp $
 
 DISTNAME=      keychain-2.9.8
-PKGREVISION=   2
+PKGREVISION=   3
 CATEGORIES=    security
 MASTER_SITES=  ${MASTER_SITE_GITHUB:=funtoo/}
 
@@ -33,18 +33,18 @@ INSTALLATION_DIRS=  bin ${PKGMANDIR}/man1
                        share/bash-completion/completions
 
 do-install:
-       ${INSTALL_SCRIPT} ${WRKSRC}/keychain ${DESTDIR}${PREFIX}/bin/keychain
+       ${INSTALL_SCRIPT} ${WRKSRC}/keychain ${DESTDIR}${PREFIX}/bin
        ${INSTALL_MAN} ${WRKSRC}/keychain.1     \
                ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1
        ${INSTALL_DATA} ${WRKSRC}/README.md     \
                ${DESTDIR}${PREFIX}/share/doc/${PKGBASE}
 
 post-install:
-       $(INSTALL_DATA) ${WRKSRC}/completions/keychain.bash     \
+       ${INSTALL_DATA} ${WRKSRC}/completions/keychain.bash     \
                ${DESTDIR}${PREFIX}/share/bash-completion/completions
        ${INSTALL_SCRIPT} ${FILESDIR}/startkeychain.sh          \
                ${DESTDIR}${PREFIX}/bin/startkeychain
-       ${INSTALL_DATA} ${FILESDIR}/README.pkgsrc               \
-               ${DESTDIR}${PREFIX}/share/doc/${PKGBASE}
+       ${INSTALL_MAN} ${FILESDIR}/startkeychain.1              \
+               ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1
 
 .include "../../mk/bsd.pkg.mk"

Index: pkgsrc/security/keychain/PLIST
diff -u pkgsrc/security/keychain/PLIST:1.8 pkgsrc/security/keychain/PLIST:1.9
--- pkgsrc/security/keychain/PLIST:1.8  Sat Nov  8 12:36:13 2025
+++ pkgsrc/security/keychain/PLIST      Sat Nov  8 19:13:40 2025
@@ -1,7 +1,7 @@
-@comment $NetBSD: PLIST,v 1.8 2025/11/08 12:36:13 vins Exp $
+@comment $NetBSD: PLIST,v 1.9 2025/11/08 19:13:40 vins Exp $
 bin/keychain
 bin/startkeychain
 man/man1/keychain.1
+man/man1/startkeychain.1
 share/bash-completion/completions/keychain.bash
 share/doc/keychain/README.md
-share/doc/keychain/README.pkgsrc

Added files:

Index: pkgsrc/security/keychain/files/startkeychain.1
diff -u /dev/null pkgsrc/security/keychain/files/startkeychain.1:1.1
--- /dev/null   Sat Nov  8 19:13:40 2025
+++ pkgsrc/security/keychain/files/startkeychain.1      Sat Nov  8 19:13:40 2025
@@ -0,0 +1,68 @@
+.\" Written by Paolo Vincenzo Olivo <vins%NetBSD.org@localhost> (2025)
+.\" License: public domain 
+.Dd November 8, 2025
+.Dt STARTKEYCHAIN 1
+.Os
+.Sh NAME
+.Nm startkeychain 
+.Nd keychain launcher  
+.Sh SYNOPSIS
+.Nm
+.Op Fl cefh 
+.Sh DESCRIPTION
+.Pp
+.Xr keychain 1 is a manager for both ssh-agent and gpg-agent. It allows
+shells and cron jobs to share a single ssh-agent or gpg-agent
+process. keychain typically runs from the login shell environment
+setting, i.e ~/.shrc.
+.Pp
+.Nm
+is a companion script for keychain, designed to automate its usage. The
+script loads all SSH and GPG keys requested by the user, and updates the
+environment by sourcing the generated files found in the
+~/.keychain directory.
+.Sh OPTIONS
+ When used interactively, startkeychain accepts a number of options: 
+.Bl -tag -width Ds
+.It Fl c 
+wipes all existing cached keys/passphrases first.
+.It Fl e
+ensures that only the specified keys are loaded.
+.It Fl f
+allow keychain to use a forwarded ssh-agent connection.
+.It Fl h
+print usage.
+.Sh ENVIRONMENT
+The following environment variables affect the execution of
+.Nm :
+.Bl -tag -width KCHOPTS
+.It Ev KCHOPTS
+This variable takes options for keychain like "--nocolor" or "--noask".
+See the keychain manpage for a full list. By default, startkeychain will
+pass `--quiet' to the keychain command line, making keychain only print
+messages in case of warning, error or required interactivity.
+.It Ev SSHKEYS
+This variable contains the list of keys to be loaded by their file
+names. The key list has to be space separated. If SSHKEYS is unset,
+startkeychain will attempt to load all user's ssh keys found in ~/.ssh,
+to an ssh-agent process
+.It Ev GPKEYS
+gpg keys to be loaded by keychain have to be specified by their key ID.
+The user can get a full list of keys and IDs in his secret keyring by
+running `gpg2 --list-secret-keys'. GPGKEYS defines a single key ID or a
+space separated list of key IDs. If GPGKEYS is unset, startkeychain will
+not attempt to load any.
+.El
+.Pp
+Defaults my be overridden by either setting these variables on the
+command line or inside a dedicated ~/.keychainrc configuration file.
+An example ~/.keychainrc may look as follows:
+
+.Bd -literal -offset indent
+KCHOPTS="--gpg2 --noask --quiet"
+SSHKEYS="user_rsa user_ed25519"
+GPGKEYS="user%netbsd.org@localhost
+.Sh SEE ALSO
+.Xr keychain 1 ,
+.Xr ssh-agent 1 ,
+.Xr gpg-agent 1