Updated manual page to show new SSH service.
git-svn-id: https://shellinabox.googlecode.com/svn/trunk@155 0da03de8-d603-11dd-86c2-0f8696b7b6f9
This commit is contained in:
parent
0a834e6488
commit
01e6f3c9de
9 changed files with 63 additions and 33 deletions
15
Makefile.am
15
Makefile.am
|
@ -143,18 +143,17 @@ shellinaboxd.1: shellinabox/shellinaboxd.man.in config.h
|
||||||
if [ `sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
if [ `sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
||||||
egrep 'HAVE_OPENSSL_BIO_H|HAVE_OPENSSL_ERR_H|HAVE_OPENSSL_SSL_H'|\
|
egrep 'HAVE_OPENSSL_BIO_H|HAVE_OPENSSL_ERR_H|HAVE_OPENSSL_SSL_H'|\
|
||||||
wc -l` -eq 3 ]; then \
|
wc -l` -eq 3 ]; then \
|
||||||
sed -e '/^#ifdef *HAVE_OPENSSL$$/d' \
|
sed -e '/^#ifndef *HAVE_OPENSSL$$/,/^#endif$$/d' "$$src"; \
|
||||||
-e '/^#endif$$/d' "$$src" >"$@"; \
|
|
||||||
else \
|
else \
|
||||||
sed -e '/^#ifdef *HAVE_OPENSSL$$/,/^#endif$$/d' "$$src" >"$@"; \
|
sed -e '/^#ifdef *HAVE_OPENSSL$$/,/^#endif$$/d' "$$src"; \
|
||||||
fi; \
|
fi | \
|
||||||
if sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
if sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
||||||
grep 'HAVE_SECURITY_PAM_APPL_H' >/dev/null 2>&1; then \
|
grep 'HAVE_SECURITY_PAM_APPL_H' >/dev/null 2>&1; then \
|
||||||
sed -e '/^#ifdef *HAVE_PAM$$/d' \
|
sed -e '/^#ifndef *HAVE_PAM$$/,/^#endif$$/d'; \
|
||||||
-e '/^#endif$$/d' "$$src" >"$@"; \
|
|
||||||
else \
|
else \
|
||||||
sed -e '/^#ifdef *HAVE_PAM$$/,/^#endif$$/d' "$$src" >"$@"; \
|
sed -e '/^#ifdef *HAVE_PAM$$/,/^#endif$$/d'; \
|
||||||
fi
|
fi | \
|
||||||
|
sed -e '/^#/d' >"$@"
|
||||||
@out=`echo "$@" 2>/dev/null|sed -e 's/\.[^.]*$$/.ps/'`; \
|
@out=`echo "$@" 2>/dev/null|sed -e 's/\.[^.]*$$/.ps/'`; \
|
||||||
man -Tps "./$@" >"$${out}" 2>/dev/null || rm -f "$${out}"
|
man -Tps "./$@" >"$${out}" 2>/dev/null || rm -f "$${out}"
|
||||||
|
|
||||||
|
|
15
Makefile.in
15
Makefile.in
|
@ -1057,18 +1057,17 @@ shellinaboxd.1: shellinabox/shellinaboxd.man.in config.h
|
||||||
if [ `sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
if [ `sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
||||||
egrep 'HAVE_OPENSSL_BIO_H|HAVE_OPENSSL_ERR_H|HAVE_OPENSSL_SSL_H'|\
|
egrep 'HAVE_OPENSSL_BIO_H|HAVE_OPENSSL_ERR_H|HAVE_OPENSSL_SSL_H'|\
|
||||||
wc -l` -eq 3 ]; then \
|
wc -l` -eq 3 ]; then \
|
||||||
sed -e '/^#ifdef *HAVE_OPENSSL$$/d' \
|
sed -e '/^#ifndef *HAVE_OPENSSL$$/,/^#endif$$/d' "$$src"; \
|
||||||
-e '/^#endif$$/d' "$$src" >"$@"; \
|
|
||||||
else \
|
else \
|
||||||
sed -e '/^#ifdef *HAVE_OPENSSL$$/,/^#endif$$/d' "$$src" >"$@"; \
|
sed -e '/^#ifdef *HAVE_OPENSSL$$/,/^#endif$$/d' "$$src"; \
|
||||||
fi; \
|
fi | \
|
||||||
if sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
if sed -e 's/^#define \([^ ]*\).*/\1/' -e t -e d config.h | \
|
||||||
grep 'HAVE_SECURITY_PAM_APPL_H' >/dev/null 2>&1; then \
|
grep 'HAVE_SECURITY_PAM_APPL_H' >/dev/null 2>&1; then \
|
||||||
sed -e '/^#ifdef *HAVE_PAM$$/d' \
|
sed -e '/^#ifndef *HAVE_PAM$$/,/^#endif$$/d'; \
|
||||||
-e '/^#endif$$/d' "$$src" >"$@"; \
|
|
||||||
else \
|
else \
|
||||||
sed -e '/^#ifdef *HAVE_PAM$$/,/^#endif$$/d' "$$src" >"$@"; \
|
sed -e '/^#ifdef *HAVE_PAM$$/,/^#endif$$/d'; \
|
||||||
fi
|
fi | \
|
||||||
|
sed -e '/^#/d' >"$@"
|
||||||
@out=`echo "$@" 2>/dev/null|sed -e 's/\.[^.]*$$/.ps/'`; \
|
@out=`echo "$@" 2>/dev/null|sed -e 's/\.[^.]*$$/.ps/'`; \
|
||||||
man -Tps "./$@" >"$${out}" 2>/dev/null || rm -f "$${out}"
|
man -Tps "./$@" >"$${out}" 2>/dev/null || rm -f "$${out}"
|
||||||
|
|
||||||
|
|
2
config.h
2
config.h
|
@ -135,7 +135,7 @@
|
||||||
#define STDC_HEADERS 1
|
#define STDC_HEADERS 1
|
||||||
|
|
||||||
/* Most recent revision number in the version control system */
|
/* Most recent revision number in the version control system */
|
||||||
#define VCS_REVISION "153"
|
#define VCS_REVISION "155"
|
||||||
|
|
||||||
/* Version number of package */
|
/* Version number of package */
|
||||||
#define VERSION "2.9"
|
#define VERSION "2.9"
|
||||||
|
|
2
configure
vendored
2
configure
vendored
|
@ -2037,7 +2037,7 @@ ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $
|
||||||
ac_compiler_gnu=$ac_cv_c_compiler_gnu
|
ac_compiler_gnu=$ac_cv_c_compiler_gnu
|
||||||
|
|
||||||
|
|
||||||
VCS_REVISION=153
|
VCS_REVISION=155
|
||||||
|
|
||||||
|
|
||||||
cat >>confdefs.h <<_ACEOF
|
cat >>confdefs.h <<_ACEOF
|
||||||
|
|
|
@ -2,7 +2,7 @@ AC_PREREQ(2.57)
|
||||||
|
|
||||||
dnl This is the one location where the authoritative version number is stored
|
dnl This is the one location where the authoritative version number is stored
|
||||||
AC_INIT(shellinabox, 2.9, markus@shellinabox.com)
|
AC_INIT(shellinabox, 2.9, markus@shellinabox.com)
|
||||||
VCS_REVISION=153
|
VCS_REVISION=155
|
||||||
AC_SUBST(VCS_REVISION)
|
AC_SUBST(VCS_REVISION)
|
||||||
AC_DEFINE_UNQUOTED(VCS_REVISION, "${VCS_REVISION}",
|
AC_DEFINE_UNQUOTED(VCS_REVISION, "${VCS_REVISION}",
|
||||||
[Most recent revision number in the version control system])
|
[Most recent revision number in the version control system])
|
||||||
|
|
|
@ -1693,7 +1693,7 @@ VT100.prototype.toggleBell = function() {
|
||||||
};
|
};
|
||||||
|
|
||||||
VT100.prototype.about = function() {
|
VT100.prototype.about = function() {
|
||||||
alert("VT100 Terminal Emulator " + "2.9 (revision 153)" +
|
alert("VT100 Terminal Emulator " + "2.9 (revision 155)" +
|
||||||
"\nCopyright 2008-2009 by Markus Gutschke\n" +
|
"\nCopyright 2008-2009 by Markus Gutschke\n" +
|
||||||
"For more information check http://shellinabox.com");
|
"For more information check http://shellinabox.com");
|
||||||
};
|
};
|
||||||
|
|
|
@ -355,7 +355,7 @@ ShellInABox.prototype.extendContextMenu = function(entries, actions) {
|
||||||
};
|
};
|
||||||
|
|
||||||
ShellInABox.prototype.about = function() {
|
ShellInABox.prototype.about = function() {
|
||||||
alert("Shell In A Box version " + "2.9 (revision 153)" +
|
alert("Shell In A Box version " + "2.9 (revision 155)" +
|
||||||
"\nCopyright 2008-2009 by Markus Gutschke\n" +
|
"\nCopyright 2008-2009 by Markus Gutschke\n" +
|
||||||
"For more information check http://shellinabox.com" +
|
"For more information check http://shellinabox.com" +
|
||||||
(typeof serverSupportsSSL != 'undefined' && serverSupportsSSL ?
|
(typeof serverSupportsSSL != 'undefined' && serverSupportsSSL ?
|
||||||
|
|
|
@ -51,7 +51,9 @@ shellinaboxd \- publish command line shell through AJAX interface
|
||||||
.TP
|
.TP
|
||||||
.B shellinaboxd
|
.B shellinaboxd
|
||||||
[\ \fB-b\fP\ | \fB--background\fP[\fB=\fP\fIpidfile\fP]\ ]
|
[\ \fB-b\fP\ | \fB--background\fP[\fB=\fP\fIpidfile\fP]\ ]
|
||||||
|
#ifdef HAVE_OPENSSL
|
||||||
[\ \fB-c\fP\ | \fB--cert=\fP\fIcertdir\fP\ ]
|
[\ \fB-c\fP\ | \fB--cert=\fP\fIcertdir\fP\ ]
|
||||||
|
#endif
|
||||||
[\ \fB--cert-fd=\fP\fIfd\fP\ ]
|
[\ \fB--cert-fd=\fP\fIfd\fP\ ]
|
||||||
[\ \fB--cgi\fP[\fB=\fP\fIportrange\fP]\ ]
|
[\ \fB--cgi\fP[\fB=\fP\fIportrange\fP]\ ]
|
||||||
[\ \fB-d\fP\ | \fB--debug\fP\ ]
|
[\ \fB-d\fP\ | \fB--debug\fP\ ]
|
||||||
|
@ -64,7 +66,9 @@ shellinaboxd \- publish command line shell through AJAX interface
|
||||||
[\ \fB-n\fP\ | \fB--numeric\fP\ ]
|
[\ \fB-n\fP\ | \fB--numeric\fP\ ]
|
||||||
[\ \fB-p\fP\ | \fB--port=\fP\fIport\fP\ ]
|
[\ \fB-p\fP\ | \fB--port=\fP\fIport\fP\ ]
|
||||||
[\ \fB-s\fP\ | \fB--service=\fP\fIservice\fP\ ]
|
[\ \fB-s\fP\ | \fB--service=\fP\fIservice\fP\ ]
|
||||||
|
#ifdef HAVE_OPENSSL
|
||||||
[\ \fB-t\fP\ | \fB--disable-ssl\fP\ ]
|
[\ \fB-t\fP\ | \fB--disable-ssl\fP\ ]
|
||||||
|
#endif
|
||||||
[\ \fB--disable-ssl-menu\fP\ ]
|
[\ \fB--disable-ssl-menu\fP\ ]
|
||||||
[\ \fB-q\fP\ | \fB--quiet\fP\ ]
|
[\ \fB-q\fP\ | \fB--quiet\fP\ ]
|
||||||
[\ \fB-u\fP\ | \fB--user=\fP\fIuid\fP\ ]
|
[\ \fB-u\fP\ | \fB--user=\fP\fIuid\fP\ ]
|
||||||
|
@ -100,6 +104,7 @@ Launch
|
||||||
.B shellinaboxd
|
.B shellinaboxd
|
||||||
as a background daemon process. Optionally, write the process id to
|
as a background daemon process. Optionally, write the process id to
|
||||||
.IR pidfile .
|
.IR pidfile .
|
||||||
|
#ifdef HAVE_OPENSSL
|
||||||
.TP
|
.TP
|
||||||
\fB-c\fP\ |\ \fB--cert=\fP\fIcertdir\fP
|
\fB-c\fP\ |\ \fB--cert=\fP\fIcertdir\fP
|
||||||
If built with SSL/TLS support enabled, the daemon will look in
|
If built with SSL/TLS support enabled, the daemon will look in
|
||||||
|
@ -151,6 +156,7 @@ where the certificate and key can be retrieved. While this option disables
|
||||||
.B SNI
|
.B SNI
|
||||||
support, it does offer an alternative solution for securely providing
|
support, it does offer an alternative solution for securely providing
|
||||||
the private key data to the daemon.
|
the private key data to the daemon.
|
||||||
|
#endif
|
||||||
.TP
|
.TP
|
||||||
\fB--cgi\fP[\fB=\fP\fIportrange\fP]
|
\fB--cgi\fP[\fB=\fP\fIportrange\fP]
|
||||||
Instead of running
|
Instead of running
|
||||||
|
@ -302,13 +308,16 @@ virtual hosting.
|
||||||
\fB-s\fP\ |\ \fB--service=\fP\fIservice\fP
|
\fB-s\fP\ |\ \fB--service=\fP\fIservice\fP
|
||||||
One or more services can be registered on different URL paths:
|
One or more services can be registered on different URL paths:
|
||||||
.in +4
|
.in +4
|
||||||
\fISERVICE\fP := <url-path> ':' \fIAPPLICATON\fP
|
\fISERVICE\fP := <url-path> ':' \fIAPPLICATION\fP
|
||||||
.in
|
.in
|
||||||
There is one pre-defined \fIapplication\fP, 'LOGIN'. It causes the
|
|
||||||
|
There is a pre-defined \fIapplication\fP, 'LOGIN', which causes the
|
||||||
daemon to invoke
|
daemon to invoke
|
||||||
.B /bin/login
|
.B /bin/login
|
||||||
to request the user's name and password, and to start his
|
requesting the user's name and password, and starting his
|
||||||
login shell. This is the default option, if no
|
login shell. This is the default option for the
|
||||||
|
.B root
|
||||||
|
user, if no
|
||||||
.B --service
|
.B --service
|
||||||
was defined. Starting
|
was defined. Starting
|
||||||
.B /bin/login
|
.B /bin/login
|
||||||
|
@ -316,10 +325,22 @@ requires
|
||||||
.B root
|
.B root
|
||||||
privileges.
|
privileges.
|
||||||
|
|
||||||
|
There is another pre-defined \fIapplication\fP, 'SSH'. Instead of invoking
|
||||||
|
.BR /bin/login ,
|
||||||
|
it calls
|
||||||
|
.BR ssh .
|
||||||
|
This is the default option for unprivileged users, if no
|
||||||
|
.B --service
|
||||||
|
was defined. This operation is available to both privileged and regular
|
||||||
|
users. If the optional \fIhost\fP parameter is omitted,
|
||||||
|
.B shellinaboxd
|
||||||
|
connects to
|
||||||
|
.BR localhost .
|
||||||
|
|
||||||
Alternatively, an \fIapplication\fP can be specified by providing a
|
Alternatively, an \fIapplication\fP can be specified by providing a
|
||||||
\fIuser\fP description, a working directory, and a command line:
|
\fIuser\fP description, a working directory, and a command line:
|
||||||
.in +4
|
.in +4
|
||||||
\fIAPPLICATION\fP := 'LOGIN' | \fIUSER\fP ':' \fICWD\fP ':' <cmdline>
|
\fIAPPLICATION\fP := 'LOGIN' | 'SSH' [ ':' <host> ] | \fIUSER\fP ':' \fICWD\fP ':' <cmdline>
|
||||||
|
|
||||||
#ifdef HAVE_PAM
|
#ifdef HAVE_PAM
|
||||||
.in
|
.in
|
||||||
|
@ -328,9 +349,11 @@ be requested interactively, instead of being provided as part of the
|
||||||
\fIservice\fP description:
|
\fIservice\fP description:
|
||||||
.in +4
|
.in +4
|
||||||
#endif
|
#endif
|
||||||
\fIUSER\fP :=
|
|
||||||
#ifdef HAVE_PAM
|
#ifdef HAVE_PAM
|
||||||
'AUTH' |
|
\fIUSER\fP := 'AUTH' |
|
||||||
|
#endif
|
||||||
|
#ifndef HAVE_PAM
|
||||||
|
\fIUSER\fP :=
|
||||||
#endif
|
#endif
|
||||||
<username> ':' <groupname>
|
<username> ':' <groupname>
|
||||||
.in
|
.in
|
||||||
|
@ -391,11 +414,19 @@ If no explicit
|
||||||
.B --service
|
.B --service
|
||||||
has been requested,
|
has been requested,
|
||||||
.B shellinaboxd
|
.B shellinaboxd
|
||||||
defaults to attaching
|
defaults to attaching the default service to the root directory of the web
|
||||||
.B /bin/login
|
server. For
|
||||||
to the root directory of the web server. This is equivalent to saying
|
.BR root ,
|
||||||
.BR --service=/:LOGIN .
|
this is
|
||||||
|
.BR /bin/login ,
|
||||||
|
and for unprivileged users, this is \fBssh localhost\fP. This is equivalent
|
||||||
|
to saying
|
||||||
|
.BR --service=/:LOGIN ,
|
||||||
|
or
|
||||||
|
.BR --service=/:SSH ,
|
||||||
|
respectively.
|
||||||
.RE
|
.RE
|
||||||
|
#ifdef HAVE_OPENSSL
|
||||||
.TP
|
.TP
|
||||||
\fB-t\fP\ |\ \fB--disable-ssl\fP
|
\fB-t\fP\ |\ \fB--disable-ssl\fP
|
||||||
By default,
|
By default,
|
||||||
|
@ -406,6 +437,7 @@ undesired, this behavior can be disabled.
|
||||||
|
|
||||||
This option is also useful during testing or for deployment in trusted
|
This option is also useful during testing or for deployment in trusted
|
||||||
intranets, if SSL certificates are unavailable.
|
intranets, if SSL certificates are unavailable.
|
||||||
|
#endif
|
||||||
.TP
|
.TP
|
||||||
\fB--disable-ssl-menu\fP
|
\fB--disable-ssl-menu\fP
|
||||||
If the user should not be able to switch between HTTP and HTTPS modes, this
|
If the user should not be able to switch between HTTP and HTTPS modes, this
|
||||||
|
|
|
@ -1693,7 +1693,7 @@ VT100.prototype.toggleBell = function() {
|
||||||
};
|
};
|
||||||
|
|
||||||
VT100.prototype.about = function() {
|
VT100.prototype.about = function() {
|
||||||
alert("VT100 Terminal Emulator " + "2.9 (revision 153)" +
|
alert("VT100 Terminal Emulator " + "2.9 (revision 155)" +
|
||||||
"\nCopyright 2008-2009 by Markus Gutschke\n" +
|
"\nCopyright 2008-2009 by Markus Gutschke\n" +
|
||||||
"For more information check http://shellinabox.com");
|
"For more information check http://shellinabox.com");
|
||||||
};
|
};
|
||||||
|
|
Loading…
Reference in a new issue