release/src-rt-6.x.4708/router/dropbear/dropbear.8

   1 .TH dropbear 8
   2 .SH NAME
   3 dropbear \- lightweight SSH server
   4 .SH SYNOPSIS
   5 .B dropbear
   6 [\-RFEmwsgjki] [\-b
   7 .I banner\fR]
   8 [\-r
   9 .I hostkeyfile\fR] [\-p
  10 .IR [address:]port ]
  11 .SH DESCRIPTION
  12 .B dropbear
  13 is a small SSH server
  14 .SH OPTIONS
  15 .TP
  16 .B \-b \fIbanner
  17 bannerfile.
  18 Display the contents of the file
  19 .I banner
  20 before user login (default: none).
  21 .TP
  22 .B \-r \fIhostkey
  23 Use the contents of the file
  24 .I hostkey
  25 for the SSH hostkey.
  26 This file is generated with
  27 .BR dropbearkey (1)
  28 or automatically with the '-R' option. See "Host Key Files" below.
  29 .TP
  30 .B \-R
  31 Generate hostkeys automatically. See "Host Key Files" below.
  32 .TP
  33 .B \-F
  34 Don't fork into background.
  35 .TP
  36 .B \-E
  37 Log to standard error rather than syslog.
  38 .TP
  39 .B \-m
  40 Don't display the message of the day on login.
  41 .TP
  42 .B \-w
  43 Disallow root logins.
  44 .TP
  45 .B \-s
  46 Disable password logins.
  47 .TP
  48 .B \-g
  49 Disable password logins for root.
  50 .TP
  51 .B \-j
  52 Disable local port forwarding.
  53 .TP
  54 .B \-k
  55 Disable remote port forwarding.
  56 .TP
  57 .B \-p \fI[address:]port
  58 Listen on specified
  59 .I address
  60 and TCP
  61 .I port.
  62 If just a port is given listen
  63 on all addresses.
  64 up to 10 can be specified (default 22 if none specified).
  65 .TP
  66 .B \-i
  67 Service program mode.
  68 Use this option to run
  69 .B dropbear
  70 under TCP/IP servers like inetd, tcpsvd, or tcpserver.
  71 In program mode the \-F option is implied, and \-p options are ignored.
  72 .TP
  73 .B \-P \fIpidfile
  74 Specify a pidfile to create when running as a daemon. If not specified, the
  75 default is /var/run/dropbear.pid
  76 .TP
  77 .B \-a
  78 Allow remote hosts to connect to forwarded ports.
  79 .TP
  80 .B \-W \fIwindowsize
  81 Specify the per-channel receive window buffer size. Increasing this
  82 may improve network performance at the expense of memory use. Use -h to see the
  83 default buffer size.
  84 .TP
  85 .B \-K \fItimeout_seconds
  86 Ensure that traffic is transmitted at a certain interval in seconds. This is
  87 useful for working around firewalls or routers that drop connections after
  88 a certain period of inactivity. The trade-off is that a session may be
  89 closed if there is a temporary lapse of network connectivity. A setting
  90 if 0 disables keepalives. If no response is received for 3 consecutive keepalives the connection will be closed.
  91 .TP
  92 .B \-I \fIidle_timeout
  93 Disconnect the session if no traffic is transmitted or received for \fIidle_timeout\fR seconds.
  94 .TP
  95 .B \-V
  96 Print the version
  97
  98 .SH FILES
  99
 100 .TP
 101 Authorized Keys
 102
 103 ~/.ssh/authorized_keys can be set up to allow remote login with a RSA or DSS
 104 key. Each line is of the form
 105 .TP
 106 [restrictions] ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIgAsp... [comment]
 107
 108 and can be extracted from a Dropbear private host key with "dropbearkey -y". This is the same format as used by OpenSSH, though the restrictions are a subset (keys with unknown restrictions are ignored).
 109 Restrictions are comma separated, with double quotes around spaces in arguments.
 110 Available restrictions are:
 111
 112 .TP
 113 .B no-port-forwarding
 114 Don't allow port forwarding for this connection
 115
 116 .TP
 117 .B no-agent-forwarding
 118 Don't allow agent forwarding for this connection
 119
 120 .TP
 121 .B no-X11-forwarding
 122 Don't allow X11 forwarding for this connection
 123
 124 .TP
 125 .B no-pty
 126 Disable PTY allocation. Note that a user can still obtain most of the
 127 same functionality with other means even if no-pty is set.
 128
 129 .TP
 130 .B command="\fIforced_command\fR"
 131 Disregard the command provided by the user and always run \fIforced_command\fR.
 132
 133 The authorized_keys file and its containing ~/.ssh directory must only be
 134 writable by the user, otherwise Dropbear will not allow a login using public
 135 key authentication.
 136
 137 .TP
 138 Host Key Files
 139
 140 Host key files are read at startup from a standard location, by default
 141 /etc/dropbear/dropbear_dss_host_key, /etc/dropbear/dropbear_rsa_host_key, and
 142 /etc/dropbear/dropbear-ecdsa_host_key
 143 or specified on the commandline with -r. These are of the form generated
 144 by dropbearkey. The -R option can be used to automatically generate keys
 145 in the default location - keys will be generated after startup when the first
 146 connection is established. This had the benefit that the system /dev/urandom
 147 random number source has a better chance of being securely seeded.
 148
 149 .TP
 150 Message Of The Day
 151
 152 By default the file /etc/motd will be printed for any login shell (unless
 153 disabled at compile-time). This can also be disabled per-user
 154 by creating a file ~/.hushlogin .
 155
 156 .SH ENVIRONMENT VARIABLES
 157 Dropbear sets the standard variables USER, LOGNAME, HOME, SHELL, PATH, and TERM.
 158
 159 The variables below are set for sessions as appropriate.
 160
 161 .TP
 162 .B SSH_TTY
 163 This is set to the allocated TTY if a PTY was used.
 164
 165 .TP
 166 .B SSH_CONNECTION
 167 Contains "<remote_ip> <remote_port> <local_ip> <local_port>".
 168
 169 .TP
 170 .B DISPLAY
 171 Set X11 forwarding is used.
 172
 173 .TP
 174 .B SSH_ORIGINAL_COMMAND
 175 If a 'command=' authorized_keys option was used, the original command is specified
 176 in this variable. If a shell was requested this is set to an empty value.
 177
 178 .TP
 179 .B SSH_AUTH_SOCK
 180 Set to a forwarded ssh-agent connection.
 181
 182 .SH NOTES
 183 Dropbear only supports SSH protocol version 2.
 184
 185 .SH AUTHOR
 186 Matt Johnston (matt@ucc.asn.au).
 187 .br
 188 Gerrit Pape (pape@smarden.org) wrote this manual page.
 189 .SH SEE ALSO
 190 dropbearkey(1), dbclient(1), dropbearconvert(1)
 191 .P
 192 https://matt.ucc.asn.au/dropbear/dropbear.html