xref: /netbsd-src/crypto/external/bsd/openssh/dist/pathnames.h (revision 1c7715dda22cf2bd169e2f84953c050393e8fe9c)
1 /*	$NetBSD: pathnames.h,v 1.16 2024/07/08 22:33:44 christos Exp $	*/
2 /* $OpenBSD: pathnames.h,v 1.32 2024/05/17 00:30:24 djm Exp $ */
3 
4 /*
5  * Author: Tatu Ylonen <ylo@cs.hut.fi>
6  * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
7  *                    All rights reserved
8  *
9  * As far as I am concerned, the code I have written for this software
10  * can be used freely for any purpose.  Any derived versions of this
11  * software must be clearly marked as such, and if the derived work is
12  * incompatible with the protocol description in the RFC file, it must be
13  * called by a name other than "ssh" or "Secure Shell".
14  */
15 
16 #define ETCDIR				"/etc"
17 #define SSHDIR				ETCDIR "/ssh"
18 #define _PATH_SSH_PIDDIR		"/var/run"
19 
20 /*
21  * System-wide file containing host keys of known hosts.  This file should be
22  * world-readable.
23  */
24 #define _PATH_SSH_SYSTEM_HOSTFILE	SSHDIR "/ssh_known_hosts"
25 /* backward compat for protocol 2 */
26 #define _PATH_SSH_SYSTEM_HOSTFILE2	SSHDIR "/ssh_known_hosts2"
27 
28 /*
29  * Of these, ssh_host_key must be readable only by root, whereas ssh_config
30  * should be world-readable.
31  */
32 #define _PATH_SERVER_CONFIG_FILE	SSHDIR "/sshd_config"
33 #define _PATH_HOST_CONFIG_FILE		SSHDIR "/ssh_config"
34 #define _PATH_HOST_DSA_KEY_FILE		SSHDIR "/ssh_host_dsa_key"
35 #define _PATH_HOST_ECDSA_KEY_FILE	SSHDIR "/ssh_host_ecdsa_key"
36 #define _PATH_HOST_RSA_KEY_FILE		SSHDIR "/ssh_host_rsa_key"
37 #define _PATH_HOST_ED25519_KEY_FILE	SSHDIR "/ssh_host_ed25519_key"
38 #define _PATH_HOST_XMSS_KEY_FILE	SSHDIR "/ssh_host_xmss_key"
39 #define _PATH_DH_MODULI			ETCDIR "/moduli"
40 
41 #define _PATH_SSH_PROGRAM		"/usr/bin/ssh"
42 
43 /* Binary paths for the sshd components */
44 #define _PATH_SSHD_SESSION		"/usr/libexec/sshd-session"
45 
46 /*
47  * The process id of the daemon listening for connections is saved here to
48  * make it easier to kill the correct daemon when necessary.
49  */
50 #define _PATH_SSH_DAEMON_PID_FILE	_PATH_SSH_PIDDIR "/sshd.pid"
51 
52 /*
53  * The directory in user's home directory in which the files reside. The
54  * directory should be world-readable (though not all files are).
55  */
56 #define _PATH_SSH_USER_DIR		".ssh"
57 
58 /*
59  * Per-user file containing host keys of known hosts.  This file need not be
60  * readable by anyone except the user him/herself, though this does not
61  * contain anything particularly secret.
62  */
63 #define _PATH_SSH_USER_HOSTFILE		"~/" _PATH_SSH_USER_DIR "/known_hosts"
64 /* backward compat for protocol 2 */
65 #define _PATH_SSH_USER_HOSTFILE2	"~/" _PATH_SSH_USER_DIR "/known_hosts2"
66 
67 /*
68  * Name of the default file containing client-side authentication key. This
69  * file should only be readable by the user him/herself.
70  */
71 #define _PATH_SSH_CLIENT_ID_DSA		_PATH_SSH_USER_DIR "/id_dsa"
72 #define _PATH_SSH_CLIENT_ID_ECDSA	_PATH_SSH_USER_DIR "/id_ecdsa"
73 #define _PATH_SSH_CLIENT_ID_RSA		_PATH_SSH_USER_DIR "/id_rsa"
74 #define _PATH_SSH_CLIENT_ID_ED25519	_PATH_SSH_USER_DIR "/id_ed25519"
75 #define _PATH_SSH_CLIENT_ID_XMSS	_PATH_SSH_USER_DIR "/id_xmss"
76 #define _PATH_SSH_CLIENT_ID_ECDSA_SK	_PATH_SSH_USER_DIR "/id_ecdsa_sk"
77 #define _PATH_SSH_CLIENT_ID_ED25519_SK	_PATH_SSH_USER_DIR "/id_ed25519_sk"
78 
79 /*
80  * Configuration file in user's home directory.  This file need not be
81  * readable by anyone but the user him/herself, but does not contain anything
82  * particularly secret.  If the user's home directory resides on an NFS
83  * volume where root is mapped to nobody, this may need to be world-readable.
84  */
85 #define _PATH_SSH_USER_CONFFILE		_PATH_SSH_USER_DIR "/config"
86 
87 /*
88  * File containing a list of those rsa keys that permit logging in as this
89  * user.  This file need not be readable by anyone but the user him/herself,
90  * but does not contain anything particularly secret.  If the user's home
91  * directory resides on an NFS volume where root is mapped to nobody, this
92  * may need to be world-readable.  (This file is read by the daemon which is
93  * running as root.)
94  */
95 #define _PATH_SSH_USER_PERMITTED_KEYS	_PATH_SSH_USER_DIR "/authorized_keys"
96 
97 /* backward compat for protocol v2 */
98 #define _PATH_SSH_USER_PERMITTED_KEYS2	_PATH_SSH_USER_DIR "/authorized_keys2"
99 
100 /*
101  * Per-user and system-wide ssh "rc" files.  These files are executed with
102  * /bin/sh before starting the shell or command if they exist.  They will be
103  * passed "proto cookie" as arguments if X11 forwarding with spoofing is in
104  * use.  xauth will be run if neither of these exists.
105  */
106 #define _PATH_SSH_USER_RC		_PATH_SSH_USER_DIR "/rc"
107 #define _PATH_SSH_SYSTEM_RC		SSHDIR "/sshrc"
108 
109 /*
110  * Ssh-only version of /etc/hosts.equiv.  Additionally, the daemon may use
111  * ~/.rhosts and /etc/hosts.equiv if rhosts authentication is enabled.
112  */
113 #define _PATH_SSH_HOSTS_EQUIV		ETCDIR "/shosts.equiv"
114 #define _PATH_RHOSTS_EQUIV		"/etc/hosts.equiv"
115 
116 /*
117  * X11 base directory
118  */
119 #ifndef X11BASE
120 #define X11BASE				"/usr/X11R6"
121 #endif
122 
123 /*
124  * Default location of askpass
125  */
126 #define _PATH_SSH_ASKPASS_DEFAULT	X11BASE "/bin/ssh-askpass"
127 
128 /* Location of ssh-keysign for hostbased authentication */
129 #define _PATH_SSH_KEY_SIGN		"/usr/libexec/ssh-keysign"
130 
131 /* Location of ssh-pkcs11-helper to support keys in tokens */
132 #define _PATH_SSH_PKCS11_HELPER		"/usr/libexec/ssh-pkcs11-helper"
133 
134 /* Location of ssh-sk-helper to support keys in security keys */
135 #ifndef _PATH_SSH_SK_HELPER
136 #define _PATH_SSH_SK_HELPER		"/usr/libexec/ssh-sk-helper"
137 #endif
138 
139 /* xauth for X11 forwarding */
140 #define _PATH_XAUTH			X11BASE "/bin/xauth"
141 
142 /* UNIX domain socket for X11 server; displaynum will replace %u */
143 #define _PATH_UNIX_X "/tmp/.X11-unix/X%u"
144 
145 /* for scp */
146 #define _PATH_CP			"cp"
147 
148 /* for sftp */
149 #define _PATH_SFTP_SERVER		"/usr/libexec/sftp-server"
150 #define _PATH_LS			"ls"
151 
152 /* chroot directory for unprivileged user when UsePrivilegeSeparation=yes */
153 #ifdef __OpenBSD__
154 #define _PATH_PRIVSEP_CHROOT_DIR	"/var/empty"
155 #else
156 #define _PATH_PRIVSEP_CHROOT_DIR	"/var/chroot/sshd"
157 #endif
158 
159 #define _PATH_URANDOM			"/dev/urandom"
160 
161 /* for passwd change */
162 #define _PATH_PASSWD_PROG		"/usr/bin/passwd"
163