Mailing List Archive

[mod_backhand-users] backhand documentation?
Is there documentation for mod_backhand? I'd like to see a list of all
the possible httpd.conf settings. I got quite a few of them from the FAQ
and the configuration examples on the web site, but I can find no
official docs that list them all.

I see a list in builtins.h:

int backhand_off(request_rec *, ServerSlot *, int *, char *);
int removeSelf(request_rec *, ServerSlot *, int *, char *);
int addSelf(request_rec *, ServerSlot *, int *, char *);
int addPrediction(request_rec *, ServerSlot *, int *, char *);
int byAge(request_rec *, ServerSlot *, int *, char *);
int byCost(request_rec *, ServerSlot *, int *, char *);
int byLoad(request_rec *, ServerSlot *, int *, char *);
int byBusyChildren(request_rec *, ServerSlot *, int *, char *);
int byCPU(request_rec *, ServerSlot *, int *, char *);
int byLogWindow(request_rec *, ServerSlot *, int *, char *);
int byRandom(request_rec *, ServerSlot *, int *, char *);
int HTTPRedirectToName(request_rec *, ServerSlot *, int *, char *);
int HTTPRedirectToIP(request_rec *, ServerSlot *, int *, char *);
int bySession(request_rec *, ServerSlot *, int *, char *);

Is that all of them?


Ultimately, I'd like to figure out how to turn on backhand for the
entire webserver, except for the Location /backhand/.

Is this correct?

<Location />
Backhand byAge
Backhand byRandom
Backhand byLogWindow
Backhand byLoad
</Location>

<Location /backhand/>
Backhand backhand_off
</Location>




TIA
Monte
[mod_backhand-users] backhand documentation? [ In reply to ]
On Saturday, August 18, 2001, at 04:35 PM, Monte Ohrt wrote:
> Is there documentation for mod_backhand? I'd like to see a list of all
> the possible httpd.conf settings. I got quite a few of them from the FAQ
> and the configuration examples on the web site, but I can find no
> official docs that list them all.

The FAQ should cover them all. Also, the course notes for ApacheCon
2001 should cover them in a little more detail:

http://www.backhand.org/ApacheCon2001/US/backhand_course_notes.pdf

> I see a list in builtins.h:
>
> int backhand_off(request_rec *, ServerSlot *, int *, char *);
> int removeSelf(request_rec *, ServerSlot *, int *, char *);
> int addSelf(request_rec *, ServerSlot *, int *, char *);
> int addPrediction(request_rec *, ServerSlot *, int *, char *);
> int byAge(request_rec *, ServerSlot *, int *, char *);
> int byCost(request_rec *, ServerSlot *, int *, char *);
> int byLoad(request_rec *, ServerSlot *, int *, char *);
> int byBusyChildren(request_rec *, ServerSlot *, int *, char *);
> int byCPU(request_rec *, ServerSlot *, int *, char *);
> int byLogWindow(request_rec *, ServerSlot *, int *, char *);
> int byRandom(request_rec *, ServerSlot *, int *, char *);
> int HTTPRedirectToName(request_rec *, ServerSlot *, int *, char *);
> int HTTPRedirectToIP(request_rec *, ServerSlot *, int *, char *);
> int bySession(request_rec *, ServerSlot *, int *, char *);
>
> Is that all of them?
>
>
> Ultimately, I'd like to figure out how to turn on backhand for the
> entire webserver, except for the Location /backhand/.
>
> Is this correct?
>
> <Location />
> Backhand byAge
> Backhand byRandom
> Backhand byLogWindow
> Backhand byLoad
> </Location>
>
> <Location /backhand/>
> Backhand backhand_off
> </Location>

Actually, the place you want to look is a little further down in
builtins.c. Those listed above are the function names, but not the
string mappings. This is the code:

static struct cpd BuiltinFuncsTable[_BuiltinCount] = {
{"off", NULL, backhand_off, NULL},
{"byAge", NULL, byAge, NULL},
{"byCost", NULL, byCost, NULL},
{"byLoad", NULL, byLoad, NULL},
{"byBusyChildren", NULL, byLoad, NULL},
{"byCPU", NULL, byCPU, NULL},
{"byLogWindow", NULL, byLogWindow, NULL},
{"byRandom", NULL, byRandom, NULL},
{"removeSelf", NULL, removeSelf, NULL},
{"addSelf", NULL, addSelf, NULL},
{"addPrediction", NULL, addPrediction, NULL},
{"HTTPRedirectToName", NULL, HTTPRedirectToName, NULL},
{"HTTPRedirectToIP", NULL, HTTPRedirectToIP, NULL},
{"bySession", NULL, bySession, NULL}
};

So, "off" is the keyword not backhand_off (that is just the function
name).

So, you are almost right on how to turn it on everywhere but the
/backhand/ location. You just want "Backhand off" in the /backhand/
location definition.

The FAQ outlines all of the candidacy functions (I think). Let me know
of any errors or omissions.

http://www.backhand.org/mod_backhand/FAQ.shtml

--
Theo Schlossnagle
1024D/82844984/95FD 30F1 489E 4613 F22E 491A 7E88 364C 8284 4984
2047R/33131B65/71 F7 95 64 49 76 5D BA 3D 90 B9 9F BE 27 24 E7
[mod_backhand-users] backhand documentation? [ In reply to ]
Theo Schlossnagle wrote:
>
> The FAQ outlines all of the candidacy functions (I think). Let me know
> of any errors or omissions.


It covers them all except "removeSelf"

--
Monte Ohrt <monte@ispi.net>
http://www.ispi.net/