httpd.conf(5) man page

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

httpd.conf(5) man page

Daniel Gracia-2
Hi there!

httpdd FastCGI interface can connect seamlessly to a local TCP port,
but this is not documented on the man page.

Went to the source and found the syntax to be a little awkward (maybe
a quick fix?). Anyway, allowed me running flask/flup/bottle pretty
straightforward.

Regards!

Index: usr.sbin/httpd/httpd.conf.5
===================================================================
RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v
retrieving revision 1.101
diff -u -p -u -p -r1.101 httpd.conf.5
--- usr.sbin/httpd/httpd.conf.5 20 Jun 2018 16:43:05 -0000      1.101
+++ usr.sbin/httpd/httpd.conf.5 2 Feb 2019 11:03:48 -0000
@@ -278,12 +278,16 @@ will neither display nor generate a dire
 Enable FastCGI instead of serving files.
 The
 .Ar socket
-is a local path name within the
+can be a local path name within the
 .Xr chroot 2
 root directory of
 .Xr httpd 8
-and defaults to
-.Pa /run/slowcgi.sock .
+(defaults to
+.Pa /run/slowcgi.sock
+). Starting with colon,
+.Ar socket
+can specify a port number that will connect to INADDR_LOOPBACK
+address.
 .Pp
 The FastCGI handler will be given the following variables:
 .Pp

Reply | Threaded
Open this post in threaded view
|

Re: httpd.conf(5) man page

Hiltjo Posthuma
On Sat, Feb 02, 2019 at 12:20:03PM +0100, Daniel Gracia wrote:

> Hi there!
>
> httpdd FastCGI interface can connect seamlessly to a local TCP port,
> but this is not documented on the man page.
>
> Went to the source and found the syntax to be a little awkward (maybe
> a quick fix?). Anyway, allowed me running flask/flup/bottle pretty
> straightforward.
>
> Regards!
>
> Index: usr.sbin/httpd/httpd.conf.5
> ===================================================================
> RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v
> retrieving revision 1.101
> diff -u -p -u -p -r1.101 httpd.conf.5
> --- usr.sbin/httpd/httpd.conf.5 20 Jun 2018 16:43:05 -0000      1.101
> +++ usr.sbin/httpd/httpd.conf.5 2 Feb 2019 11:03:48 -0000
> @@ -278,12 +278,16 @@ will neither display nor generate a dire
>  Enable FastCGI instead of serving files.
>  The
>  .Ar socket
> -is a local path name within the
> +can be a local path name within the
>  .Xr chroot 2
>  root directory of
>  .Xr httpd 8
> -and defaults to
> -.Pa /run/slowcgi.sock .
> +(defaults to
> +.Pa /run/slowcgi.sock
> +). Starting with colon,
> +.Ar socket
> +can specify a port number that will connect to INADDR_LOOPBACK
> +address.
>  .Pp
>  The FastCGI handler will be given the following variables:
>  .Pp
>

Hi,

Cool, I did not know httpd could do this. The commit (git mirror) says:

"
commit 2204991274ff67f80cfd592f8470cdaca7a906e9
Author: reyk <[hidden email]>
Date:   Sat Aug 2 11:52:00 2014 +0000

    Allow to specify a FastCGI TCP socket on localhost (eg. :9000).  Used
    for debugging, you should prefer local UNIX sockets, but it helped to
    find an issue that will be fixed with the next commit.
"

CVS server_fci.c rev 1.9:
http://cvsweb.openbsd.org/src/usr.sbin/httpd/server_fcgi.c?rev=1.9&content-type=text/x-cvsweb-markup

So maybe it was a debugging feature.

--
Kind regards,
Hiltjo

Reply | Threaded
Open this post in threaded view
|

Re: httpd.conf(5) man page

Daniel Gracia-2
That explains by it is not documented and the somewhat awkward syntax.
Will take care with future use cases. Thanks for the info!

El sáb., 2 feb. 2019 a las 12:52, Hiltjo Posthuma
(<[hidden email]>) escribió:

>
> On Sat, Feb 02, 2019 at 12:20:03PM +0100, Daniel Gracia wrote:
> > Hi there!
> >
> > httpdd FastCGI interface can connect seamlessly to a local TCP port,
> > but this is not documented on the man page.
> >
> > Went to the source and found the syntax to be a little awkward (maybe
> > a quick fix?). Anyway, allowed me running flask/flup/bottle pretty
> > straightforward.
> >
> > Regards!
> >
> > Index: usr.sbin/httpd/httpd.conf.5
> > ===================================================================
> > RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v
> > retrieving revision 1.101
> > diff -u -p -u -p -r1.101 httpd.conf.5
> > --- usr.sbin/httpd/httpd.conf.5 20 Jun 2018 16:43:05 -0000      1.101
> > +++ usr.sbin/httpd/httpd.conf.5 2 Feb 2019 11:03:48 -0000
> > @@ -278,12 +278,16 @@ will neither display nor generate a dire
> >  Enable FastCGI instead of serving files.
> >  The
> >  .Ar socket
> > -is a local path name within the
> > +can be a local path name within the
> >  .Xr chroot 2
> >  root directory of
> >  .Xr httpd 8
> > -and defaults to
> > -.Pa /run/slowcgi.sock .
> > +(defaults to
> > +.Pa /run/slowcgi.sock
> > +). Starting with colon,
> > +.Ar socket
> > +can specify a port number that will connect to INADDR_LOOPBACK
> > +address.
> >  .Pp
> >  The FastCGI handler will be given the following variables:
> >  .Pp
> >
>
> Hi,
>
> Cool, I did not know httpd could do this. The commit (git mirror) says:
>
> "
> commit 2204991274ff67f80cfd592f8470cdaca7a906e9
> Author: reyk <[hidden email]>
> Date:   Sat Aug 2 11:52:00 2014 +0000
>
>     Allow to specify a FastCGI TCP socket on localhost (eg. :9000).  Used
>     for debugging, you should prefer local UNIX sockets, but it helped to
>     find an issue that will be fixed with the next commit.
> "
>
> CVS server_fci.c rev 1.9:
> http://cvsweb.openbsd.org/src/usr.sbin/httpd/server_fcgi.c?rev=1.9&content-type=text/x-cvsweb-markup
>
> So maybe it was a debugging feature.
>
> --
> Kind regards,
> Hiltjo

Reply | Threaded
Open this post in threaded view
|

Re: httpd.conf(5) man page

Florian Obser-2
In reply to this post by Daniel Gracia-2
On Sat, Feb 02, 2019 at 12:20:03PM +0100, Daniel Gracia wrote:
> Hi there!
>
> httpdd FastCGI interface can connect seamlessly to a local TCP port,
> but this is not documented on the man page.

Thanks for pointing this out. I worked with jmc on rewording the
fastcgi socket description a bit.

>
> Went to the source and found the syntax to be a little awkward (maybe
> a quick fix?). Anyway, allowed me running flask/flup/bottle pretty
> straightforward.
>
> Regards!
>
> Index: usr.sbin/httpd/httpd.conf.5
> ===================================================================
> RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v
> retrieving revision 1.101
> diff -u -p -u -p -r1.101 httpd.conf.5
> --- usr.sbin/httpd/httpd.conf.5 20 Jun 2018 16:43:05 -0000      1.101
> +++ usr.sbin/httpd/httpd.conf.5 2 Feb 2019 11:03:48 -0000
> @@ -278,12 +278,16 @@ will neither display nor generate a dire
>  Enable FastCGI instead of serving files.
>  The
>  .Ar socket
> -is a local path name within the
> +can be a local path name within the
>  .Xr chroot 2
>  root directory of
>  .Xr httpd 8
> -and defaults to
> -.Pa /run/slowcgi.sock .
> +(defaults to
> +.Pa /run/slowcgi.sock
> +). Starting with colon,
> +.Ar socket
> +can specify a port number that will connect to INADDR_LOOPBACK
> +address.
>  .Pp
>  The FastCGI handler will be given the following variables:
>  .Pp
>

--
I'm not entirely sure you are real.