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:
zodiac 2009-07-29 21:08:06 +00:00
parent 0a834e6488
commit 01e6f3c9de
9 changed files with 63 additions and 33 deletions

View file

@ -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}"

View file

@ -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}"

View file

@ -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
View file

@ -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

View file

@ -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])

View file

@ -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");
}; };

View file

@ -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 ?

View file

@ -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

View file

@ -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");
}; };