Home | History | Annotate | Line # | Download | only in dist
      1 /*	$NetBSD: pathnames.h,v 1.18 2025/10/11 15:45:07 christos Exp $	*/
      2 /* $OpenBSD: pathnames.h,v 1.36 2025/08/29 03:50:38 djm Exp $ */
      3 
      4 /*
      5  * Author: Tatu Ylonen <ylo (at) cs.hut.fi>
      6  * Copyright (c) 1995 Tatu Ylonen <ylo (at) 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_ECDSA_KEY_FILE	SSHDIR "/ssh_host_ecdsa_key"
     35 #define _PATH_HOST_RSA_KEY_FILE		SSHDIR "/ssh_host_rsa_key"
     36 #define _PATH_HOST_ED25519_KEY_FILE	SSHDIR "/ssh_host_ed25519_key"
     37 #define _PATH_DH_MODULI			ETCDIR "/moduli"
     38 
     39 #define _PATH_SSH_PROGRAM		"/usr/bin/ssh"
     40 
     41 /* Binary paths for the sshd components */
     42 #define _PATH_SSHD_SESSION		"/usr/libexec/sshd-session"
     43 #define _PATH_SSHD_AUTH			"/usr/libexec/sshd-auth"
     44 
     45 /*
     46  * The process id of the daemon listening for connections is saved here to
     47  * make it easier to kill the correct daemon when necessary.
     48  */
     49 #define _PATH_SSH_DAEMON_PID_FILE	_PATH_SSH_PIDDIR "/sshd.pid"
     50 
     51 /*
     52  * The directory in user's home directory in which the files reside. The
     53  * directory should be world-readable (though not all files are).
     54  */
     55 #define _PATH_SSH_USER_DIR		".ssh"
     56 
     57 
     58 /*
     59  * The directory in which ssh-agent sockets and agent sockets forwarded by
     60  * sshd reside. This directory should not be world-readable.
     61  */
     62 #define _PATH_SSH_AGENT_SOCKET_DIR _PATH_SSH_USER_DIR "/agent"
     63 
     64 /*
     65  * Per-user file containing host keys of known hosts.  This file need not be
     66  * readable by anyone except the user him/herself, though this does not
     67  * contain anything particularly secret.
     68  */
     69 #define _PATH_SSH_USER_HOSTFILE		"~/" _PATH_SSH_USER_DIR "/known_hosts"
     70 /* backward compat for protocol 2 */
     71 #define _PATH_SSH_USER_HOSTFILE2	"~/" _PATH_SSH_USER_DIR "/known_hosts2"
     72 
     73 /*
     74  * Name of the default file containing client-side authentication key. This
     75  * file should only be readable by the user him/herself.
     76  */
     77 #define _PATH_SSH_CLIENT_ID_ECDSA	_PATH_SSH_USER_DIR "/id_ecdsa"
     78 #define _PATH_SSH_CLIENT_ID_RSA		_PATH_SSH_USER_DIR "/id_rsa"
     79 #define _PATH_SSH_CLIENT_ID_ED25519	_PATH_SSH_USER_DIR "/id_ed25519"
     80 #define _PATH_SSH_CLIENT_ID_ECDSA_SK	_PATH_SSH_USER_DIR "/id_ecdsa_sk"
     81 #define _PATH_SSH_CLIENT_ID_ED25519_SK	_PATH_SSH_USER_DIR "/id_ed25519_sk"
     82 
     83 /*
     84  * Configuration file in user's home directory.  This file need not be
     85  * readable by anyone but the user him/herself, but does not contain anything
     86  * particularly secret.  If the user's home directory resides on an NFS
     87  * volume where root is mapped to nobody, this may need to be world-readable.
     88  */
     89 #define _PATH_SSH_USER_CONFFILE		_PATH_SSH_USER_DIR "/config"
     90 
     91 /*
     92  * File containing a list of those rsa keys that permit logging in as this
     93  * user.  This file need not be readable by anyone but the user him/herself,
     94  * but does not contain anything particularly secret.  If the user's home
     95  * directory resides on an NFS volume where root is mapped to nobody, this
     96  * may need to be world-readable.  (This file is read by the daemon which is
     97  * running as root.)
     98  */
     99 #define _PATH_SSH_USER_PERMITTED_KEYS	_PATH_SSH_USER_DIR "/authorized_keys"
    100 
    101 /* backward compat for protocol v2 */
    102 #define _PATH_SSH_USER_PERMITTED_KEYS2	_PATH_SSH_USER_DIR "/authorized_keys2"
    103 
    104 /*
    105  * Per-user and system-wide ssh "rc" files.  These files are executed with
    106  * /bin/sh before starting the shell or command if they exist.  They will be
    107  * passed "proto cookie" as arguments if X11 forwarding with spoofing is in
    108  * use.  xauth will be run if neither of these exists.
    109  */
    110 #define _PATH_SSH_USER_RC		_PATH_SSH_USER_DIR "/rc"
    111 #define _PATH_SSH_SYSTEM_RC		SSHDIR "/sshrc"
    112 
    113 /*
    114  * Ssh-only version of /etc/hosts.equiv.  Additionally, the daemon may use
    115  * ~/.rhosts and /etc/hosts.equiv if rhosts authentication is enabled.
    116  */
    117 #define _PATH_SSH_HOSTS_EQUIV		ETCDIR "/shosts.equiv"
    118 #define _PATH_RHOSTS_EQUIV		"/etc/hosts.equiv"
    119 
    120 /*
    121  * X11 base directory
    122  */
    123 #ifndef X11BASE
    124 #define X11BASE				"/usr/X11R6"
    125 #endif
    126 
    127 /*
    128  * Default location of askpass
    129  */
    130 #define _PATH_SSH_ASKPASS_DEFAULT	X11BASE "/bin/ssh-askpass"
    131 
    132 /* Location of ssh-keysign for hostbased authentication */
    133 #define _PATH_SSH_KEY_SIGN		"/usr/libexec/ssh-keysign"
    134 
    135 /* Location of ssh-pkcs11-helper to support keys in tokens */
    136 #define _PATH_SSH_PKCS11_HELPER		"/usr/libexec/ssh-pkcs11-helper"
    137 
    138 /* Location of ssh-sk-helper to support keys in security keys */
    139 #ifndef _PATH_SSH_SK_HELPER
    140 #define _PATH_SSH_SK_HELPER		"/usr/libexec/ssh-sk-helper"
    141 #endif
    142 
    143 /* xauth for X11 forwarding */
    144 #define _PATH_XAUTH			X11BASE "/bin/xauth"
    145 
    146 /* UNIX domain socket for X11 server; displaynum will replace %u */
    147 #define _PATH_UNIX_X "/tmp/.X11-unix/X%u"
    148 
    149 /* for scp */
    150 #define _PATH_CP			"cp"
    151 
    152 /* for sftp */
    153 #define _PATH_SFTP_SERVER		"/usr/libexec/sftp-server"
    154 #define _PATH_LS			"ls"
    155 
    156 /* chroot directory for unprivileged user when UsePrivilegeSeparation=yes */
    157 #ifdef __OpenBSD__
    158 #define _PATH_PRIVSEP_CHROOT_DIR	"/var/empty"
    159 #else
    160 #define _PATH_PRIVSEP_CHROOT_DIR	"/var/chroot/sshd"
    161 #endif
    162 
    163 #define _PATH_URANDOM			"/dev/urandom"
    164 
    165 /* for passwd change */
    166 #define _PATH_PASSWD_PROG		"/usr/bin/passwd"
    167