2009/10/26 Igor Sysoev <is@rambler-co.ru>:
> Changes with nginx 0.8.21                                        26 Oct 2009
>

Sigh. All the regression tests for my "echo" module's echo_sleep in
subrequests are hanging with this nginx version.

The tests were passing happily with 0.7.46 ~ 0.7.63 and 0.8.0 ~ 0.8.20.

I'm not sure if it's a regression or an internal event model change in
the Nginx internals.

I'd like to seek any help from the developers here in the fear of
reading the complicated source diff's and huge hours of debugging.

Basically I'm implementing non-blocking "sleep" this way:

1. Put a custom ngx_event_t member named "sleep" in my module's
per-request context struct :

typedef struct {
...
ngx_event_t sleep;
} ngx_http_echo_module_ctx_t;

(I'm not reusing the per-connection r->read or r->write events here
because I'd like my "sleep" work with subrequests.)

2. Then initialize the event object this way:

ctx->sleep.handler = ngx_http_echo_sleep_event_handler;
ctx->sleep.data = r;
ctx->sleep.log = r->connection->log;

The event handler ngx_http_echo_sleep_event_handler is coded this way
(mostly a clone of nginx's own function ngx_http_request_handler:

void
ngx_http_echo_sleep_event_handler(ngx_event_t *ev) {
ngx_connection_t *c;
ngx_http_request_t *r;
ngx_http_log_ctx_t *ctx;

r = ev->data;
c = r->connection;
ctx = c->log->data;
ctx->current_request = r;

ngx_http_echo_post_sleep(r);

ngx_http_run_posted_requests(c); # only enabled for >= 0.7.46
}

The final bit is the ngx_http_echo_post_sleep function:

static void
ngx_http_echo_post_sleep(ngx_http_request_t *r) {
ngx_http_echo_ctx_t *ctx;
ngx_int_t rc;

ctx = ngx_http_get_module_ctx(r, ngx_http_echo_module);
if ( ! ctx->sleep.timedout ) {
return;
}

ctx->sleep.timedout = 0;

if (ctx->sleep.timer_set) {
ngx_del_timer(&ctx->sleep);
}

rc = ngx_http_echo_handler(r); # my main content handler

if (rc == NGX_OK) { # only enabled for nginx_version >= 8011
r->main->count--; # not completely sure about this though
}

ngx_http_finalize_request(r, rc);
}

3. In the sleep content handler, add a timer based on the "sleep"
event to start sleeping:

r->main->count++; # only enabled for nginx_version >= 8011

ngx_add_timer(&ctx->sleep, (ngx_msec_t) (1000 * delay));

return NGX_DONE;

In 0.8.21, my "sleep" works in main requests but will hang in
subrequests. What is the key magic that I'm missing here? And a good
explanation of the r->main->count reference counter introduced in
recent 0.8.x releases will be highly appreciated as well :)

Thanks in advance!

-agentzh