/*
 * Copyright (c) 2014-2025 Paul Mattes.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *     * Neither the names of Paul Mattes nor the names of his contributors
 *       may be used to endorse or promote products derived from this software
 *       without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY PAUL MATTES "AS IS" AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
 * EVENT SHALL PAUL MATTES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/*
 *      httpd-io.c
 *              x3270 webserver, I/O module
 */

#include "globals.h"

#if !defined(_WIN32) /*[*/
# include <unistd.h>
# include <netinet/in.h>
# include <sys/select.h>
# include <arpa/inet.h>
#endif /*]*/
#include <signal.h>
#include <fcntl.h>
#include <errno.h>
#include <assert.h>

#include "appres.h"
#include "bind-opt.h"
#include "json.h"
#include "json_run.h"
#include "popups.h"
#include "resources.h"
#include "s3270_proto.h"
#include "task.h"
#include "toggles.h"
#include "trace.h"
#include "txa.h"
#include "utils.h"
#include "varbuf.h"

#include "httpd-core.h"
#include "httpd-io.h"
#include "httpd-nodes.h"

#if defined(_WIN32) /*[*/
# include "w3misc.h"
# include "winprint.h"
#endif /*]*/

#define IDLE_MAX	15

struct hio_listener {
    llist_t link;	/* list linkage */
    int n_sessions;
    socket_t listen_s;
#if defined(_WIN32) /*[*/
    HANDLE listen_event;
#endif /*]*/
    ioid_t listen_id;
    char *desc;
};

static hio_listener_t *global_listener = NULL;
static llist_t listeners = LLIST_INIT(listeners);

typedef struct {
    llist_t link;	/* list linkage */
    socket_t s;		/* socket */
#if defined(_WIN32) /*[*/
    HANDLE event;
#endif /*]*/
    void *dhandle;	/* httpd protocol handle */
    int idle;
    ioid_t ioid;	/* AddInput ID */
    ioid_t toid;	/* AddTimeOut ID */

    struct {		/* pending command state: */
	sendto_callback_t *callback; /* callback function */
	content_t return_content_type; /* return content type */
	varbuf_t result; /* accumulated result data (except for JSON) */
	json_t *jresult; /* accumulated result data (JSON) */
	bool done;	/* is the command done? */
    } pending;
    hio_listener_t *listener;
} session_t;
llist_t sessions = LLIST_INIT(sessions);

/**
 * Return the text for the most recent socket error.
 *
 * @return Error text
 */
static const char *
socket_errtext(void)
{
#if !defined(_WIN32) /*[*/
    return strerror(errno);
#else /*][*/
    return win32_strerror(GetLastError());
#endif /*]*/
}

/**
 * Close the session associated with a particular socket.
 * Called from the HTTPD logic when a fatal error or EOF occurs.
 *
 * @param[in] session	Session
 */
static void
hio_socket_close(session_t *session)
{
    SOCK_CLOSE(session->s);
    if (session->ioid != NULL_IOID) {
	RemoveInput(session->ioid);
    }
    if (session->toid != NULL_IOID) {
	RemoveTimeOut(session->toid);
    }
#if defined(_WIN32) /*[*/
    CloseHandle(session->event);
#endif /*]*/
    vb_free(&session->pending.result);
    json_free(session->pending.jresult);
    llist_unlink(&session->link);
    if (session->listener != NULL) {
	session->listener->n_sessions--;
    }
    Free(session);
}

/**
 * Walk the sessions to find the one that matches the ID.
 * If found, kill it.
 *
 * @param[in] id	I/O ID
 */
void
hio_error_timeout(ioid_t id)
{
    session_t *session = NULL;
    session_t *fatal_session = NULL;

    vctrace(TC_HTTPD, "deferred error timeout\n");
    FOREACH_LLIST(&sessions, session, session_t *) {
	if (httpd_waiting(session->dhandle, id)) {
	    fatal_session = session;
	    break;
	}
    } FOREACH_LLIST_END(&sessions, session, session_t *);
    if (fatal_session == NULL) {
	vctrace(TC_HTTPD, "deferred error timeout: not found\n");
	return;
    }

    httpd_close(fatal_session->dhandle, "deferred error timeout");
    hio_socket_close(fatal_session);
}

/**
 * httpd timeout.
 *
 * @param[in] id	timeout ID
 */
static void
hio_timeout(ioid_t id)
{
    session_t *session;

    session = NULL;
    FOREACH_LLIST(&sessions, session, session_t *) {
	if (session->toid == id) {
	    break;
	}
    } FOREACH_LLIST_END(&sessions, session, session_t *);
    if (session == NULL) {
	vctrace(TC_HTTPD, "mystery timeout\n");
	return;
    }

    session->toid = NULL_IOID;
    httpd_close(session->dhandle, "timeout");
    hio_socket_close(session);
}

/**
 * New inbound data for an httpd connection.
 *
 * @param[in] fd	socket file descriptor
 * @param[in] id	I/O ID
 */
void
hio_socket_input(iosrc_t fd, ioid_t id)
{
    session_t *session;
    char buf[1024];
    ssize_t nr;

    session = NULL;
    FOREACH_LLIST(&sessions, session, session_t *) {
	if (session->ioid == id) {
	    break;
	}
    } FOREACH_LLIST_END(&sessions, session, session_t *);
    if (session == NULL) {
	vctrace(TC_HTTPD, "mystery input\n");
	return;
    }

    /* Move this session to the front of the list. */
    llist_unlink(&session->link);
    LLIST_PREPEND(&session->link, sessions);

    session->idle = 0;

    if (session->toid != NULL_IOID) {
	RemoveTimeOut(session->toid);
	session->toid = NULL_IOID;
    }

    nr = recv(session->s, buf, sizeof(buf), 0);
    if (nr <= 0) {
	const char *ebuf;
	bool harmless = false;

	if (nr < 0) {
	    if (socket_errno() == SE_EWOULDBLOCK) {
		harmless = true;
	    }
	    ebuf = txAsprintf("recv error: %s", socket_errtext());
	    vctrace(TC_HTTPD, "%s%s\n", ebuf, harmless? " (harmless)": "");
	} else {
	    ebuf = "session EOF";
	}
	if (!harmless) {
	    httpd_close(session->dhandle, ebuf);
	    hio_socket_close(session);
	}
    } else {
	httpd_status_t rv;

	rv = httpd_input(session->dhandle, buf, nr);
	if (rv < 0) {
	    httpd_close(session->dhandle, "protocol error");
	    hio_socket_close(session);
	} else if (rv == HS_PENDING) {
	    /* Stop input on this socket. */
	    RemoveInput(session->ioid);
	    session->ioid = NULL_IOID;
	} else if (session->toid == NULL_IOID) {
	    /* Leave input enabled and start the timeout. */
	    session->toid = AddTimeOut(IDLE_MAX * 1000, hio_timeout);
	}
    }
}

/**
 * New inbound connection for httpd.
 *
 * @param[in] fd	socket file descriptor
 * @param[in] id	I/O ID
 */
void
hio_connection(iosrc_t fd, ioid_t id)
{
    hio_listener_t *l;
    bool found = false;
    socket_t t;
    union {
	struct sockaddr sa;
	struct sockaddr_in sin;
	struct sockaddr_in6 sin6;
    } sa;
    socklen_t len;
    char hostbuf[128];
    session_t *session;

    /* Find the listener. */
    FOREACH_LLIST(&listeners, l, hio_listener_t *) {
	if (l->listen_id == id) {
	    found = true;
	    break;
	}
    } FOREACH_LLIST_END(&sessions, session, session_t *);
    if (!found) {
	vctrace(TC_HTTPD, "accept: session not found\n");
	return;
    }

    /* Accept the connection. */
    len = sizeof(sa);
    t = accept(l->listen_s, &sa.sa, &len);
    if (t == INVALID_SOCKET) {
	vctrace(TC_HTTPD, "accept error: %s%s\n", socket_errtext(),
		(socket_errno() == SE_EWOULDBLOCK)? " (harmless)": "");
	return;
    }

#if !defined(_WIN32) /*[*/
    fcntl(t, F_SETFD, 1);
#endif /*]*/

    session = Malloc(sizeof(session_t));
    memset(session, 0, sizeof(session_t));
    session->listener = l;
    vb_init(&session->pending.result);
    session->pending.jresult = NULL;
    session->s = t;
#if defined(_WIN32) /*[*/
    session->event = CreateEvent(NULL, FALSE, FALSE, NULL);
    if (session->event == NULL) {
	vctrace(TC_HTTPD, "can't create socket handle\n");
	SOCK_CLOSE(t);
	Free(session);
	return;
    }
    if (WSAEventSelect(session->s, session->event, FD_READ | FD_CLOSE) != 0) {
	vctrace(TC_HTTPD, "Can't set socket handle events\n");
	CloseHandle(session->event);
	SOCK_CLOSE(t);
	Free(session);
	return;
    }
#endif /*]*/
    if (sa.sa.sa_family == AF_INET) {
	session->dhandle = httpd_new(session,
		txAsprintf("%s:%u",
		    inet_ntop(AF_INET, &sa.sin.sin_addr, hostbuf,
			sizeof(hostbuf)),
		    ntohs(sa.sin.sin_port)));
    } else if (sa.sa.sa_family == AF_INET6) {
	session->dhandle = httpd_new(session,
		txAsprintf("%s:%u",
		    inet_ntop(AF_INET6, &sa.sin6.sin6_addr, hostbuf,
			sizeof(hostbuf)),
		    ntohs(sa.sin6.sin6_port)));
    }
    else {
	session->dhandle = httpd_new(session, "???");
    }
#if !defined(_WIN32) /*[*/
    session->ioid = AddInput(t, hio_socket_input);
#else /*][*/
    session->ioid = AddInput(session->event, hio_socket_input);
#endif /*]*/

    /* Set the timeout for the first line of input. */
    session->toid = AddTimeOut(IDLE_MAX * 1000, hio_timeout);

    LLIST_APPEND(&session->link, sessions);
    l->n_sessions++;
}

/**
 * Initialize an httpd socket.
 *
 * @param[in] sa	address and port to listen on
 * @param[in] sa_len	length of sa
 *
 * @returns listen context
 */
hio_listener_t *
hio_init_x(struct sockaddr *sa, socklen_t sa_len)
{
#if !defined(_WIN32) /*[*/
    int on = 1;
#endif /*]*/
    char hostbuf[128];

    hio_listener_t *l = Calloc(sizeof(hio_listener_t), 1);
    llist_init(&l->link);

#if !defined(_WIN32) /*[*/
    l->listen_s = socket(sa->sa_family, SOCK_STREAM, 0);
#else /*][*/
    l->listen_s = WSASocket(sa->sa_family, SOCK_STREAM, 0, NULL, 0,
	    WSA_FLAG_NO_HANDLE_INHERIT);
#endif /*]*/
    if (l->listen_s == INVALID_SOCKET) {
	popup_an_error("httpd socket: %s", socket_errtext());
	goto fail;
    }
#if !defined(_WIN32) /*[*/
    if (setsockopt(l->listen_s, SOL_SOCKET, SO_REUSEADDR, (char *)&on,
		sizeof(on)) < 0) {
	popup_an_error("httpd setsockopt: %s", socket_errtext());
	SOCK_CLOSE(l->listen_s);
	l->listen_s = INVALID_SOCKET;
	goto fail;
    }
#endif /*]*/
    if (bind(l->listen_s, sa, sa_len) < 0) {
	popup_an_error("httpd bind: %s", socket_errtext());
	SOCK_CLOSE(l->listen_s);
	l->listen_s = INVALID_SOCKET;
	goto fail;
    }
    if (getsockname(l->listen_s, sa, &sa_len) < 0) {
	popup_an_error("httpd getsockname: %s", socket_errtext());
	SOCK_CLOSE(l->listen_s);
	l->listen_s = INVALID_SOCKET;
	goto fail;
    }
    if (listen(l->listen_s, 10) < 0) {
	popup_an_error("httpd listen: %s", socket_errtext());
	SOCK_CLOSE(l->listen_s);
	l->listen_s = INVALID_SOCKET;
	goto fail;
    }
#if !defined(_WIN32) /*[*/
    fcntl(l->listen_s, F_SETFD, 1);
#endif /*]*/
#if defined(_WIN32) /*[*/
    l->listen_event = CreateEvent(NULL, FALSE, FALSE, NULL);
    if (l->listen_event == NULL) {
	popup_an_error("httpd: cannot create listen handle");
	SOCK_CLOSE(l->listen_s);
	l->listen_s = INVALID_SOCKET;
	goto fail;
    }
    if (WSAEventSelect(l->listen_s, l->listen_event, FD_ACCEPT) != 0) {
	popup_an_error("httpd: WSAEventSelect failed: %s",
		socket_errtext());
	CloseHandle(l->listen_event);
	l->listen_event = INVALID_HANDLE_VALUE;
	SOCK_CLOSE(l->listen_s);
	l->listen_s = INVALID_SOCKET;
	goto fail;
    }
    l->listen_id = AddInput(l->listen_event, hio_connection);
#else /*][*/
    l->listen_id = AddInput(l->listen_s, hio_connection);
#endif /*]*/
    LLIST_APPEND(&l->link, listeners);

    if (sa->sa_family == AF_INET) {
	struct sockaddr_in *sin = (struct sockaddr_in *)sa;

	l->desc = Asprintf("%s:%u", inet_ntop(sa->sa_family,
		    &sin->sin_addr, hostbuf, sizeof(hostbuf)),
		ntohs(sin->sin_port));
	vctrace(TC_HTTPD, "Listening on %s\n", l->desc);
    } else if (sa->sa_family == AF_INET6) {
	struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)sa;

	l->desc = Asprintf("[%s]:%u", inet_ntop(sa->sa_family,
		&sin6->sin6_addr, hostbuf, sizeof(hostbuf)),
	    ntohs(sin6->sin6_port));
	vctrace(TC_HTTPD, "Listening on %s\n", l->desc);
    }

    goto done;

fail:
    Free(l);
    l = NULL;

done:
    return l;
}

/**
 * Initialize the global httpd socket.
 *
 * @param[in] sa	address and port to listen on
 * @param[in] sa_len	length of sa
 */
void
hio_init(struct sockaddr *sa, socklen_t sa_len)
{
    if (global_listener == NULL) {
	global_listener = hio_init_x(sa, sa_len);
	Free(sa);
    }
}

/**
 * Stop listening globally for HTTP connections.
 */
void
hio_stop_x(hio_listener_t *l)
{
    session_t *session;

    if (l->listen_id == NULL_IOID) {
	return;
    }

    RemoveInput(l->listen_id);
    l->listen_id = NULL_IOID;

    SOCK_CLOSE(l->listen_s);
    l->listen_s = INVALID_SOCKET;

#if defined(_WIN32) /*[*/
    CloseHandle(l->listen_event);
    l->listen_event = INVALID_HANDLE_VALUE;
#endif /*]*/

    /* Detach any sessions. */
    FOREACH_LLIST(&sessions, session, session_t *) {
	if (session->listener == l) {
	    session->listener = NULL;
	}
    } FOREACH_LLIST_END(&sessions, session, session_t *);

    l->n_sessions = 0;
    vctrace(TC_HTTPD, "Stopped listening on %s\n", l->desc);
    Replace(l->desc, NULL);
    llist_unlink(&l->link);
    Free(l);
}

/**
 * Stop listening for HTTP connections.
 */
void
hio_stop(void)
{
    if (global_listener != NULL) {
	hio_stop_x(global_listener);
	global_listener = NULL;
    }
}

/**
 * Send output on an http session.
 *
 * @param[in] mhandle	our handle
 * @param[in] buf	buffer to transmit
 * @param[in] len	length of buffer
 */
void
hio_send(void *mhandle, const char *buf, size_t len)
{
    session_t *s = mhandle;
    ssize_t nw;

    nw = send(s->s, buf, (int)len, 0);
    if (nw < 0) {
	vctrace(TC_HTTPD, "send error: %s\n", socket_errtext());
    }
}

/**
 * Incremental data callback from x3270 back to httpd.
 *
 * @param[in] handle	handle
 * @param[in] buf	buffer
 * @param[in] len	size of buffer
 * @param[in] success	true if data, false if error message
 */
static void
hio_data(task_cbh handle, const char *buf, size_t len, bool success)
{
    session_t *s = handle;

    /* Remove trailing newlines. */
    while (len > 0 && buf[len - 1] == '\n') {
        len--;
     }

    if (s->pending.return_content_type == CT_HTML) {
	size_t i;
	char c;

	/* Quote HTML in the response. */
	for (i = 0; i < len; i++) {
	    c = buf[i];
	    switch (c) {
	    case '&':
		vb_appends(&s->pending.result, "&amp;");
		break;
	    case '<':
		vb_appends(&s->pending.result, "&lt;");
		break;
	    case '>':
		vb_appends(&s->pending.result, "&gt;");
		break;
	    case '"':
		vb_appends(&s->pending.result, "&quot;");
		break;
	    default:
		vb_append(&s->pending.result, &c, 1);
		break;
	    }
	}
	vb_appends(&s->pending.result, "\n");
    } else if (s->pending.return_content_type == CT_JSON) {
	json_t *result_array;
	json_t *err_array;
	char *bcopy;
	char *bnext;
	char *newline;

	if (s->pending.jresult == NULL) {
	    s->pending.jresult = json_object();
	    result_array = json_array();
	    json_object_set(s->pending.jresult, JRET_RESULT, NT, result_array);
	    err_array = json_array();
	    json_object_set(s->pending.jresult, JRET_RESULT_ERR, NT, err_array);
	} else {
	    assert(json_object_member(s->pending.jresult, JRET_RESULT, NT, &result_array));
	    assert(json_object_member(s->pending.jresult, JRET_RESULT_ERR, NT, &err_array));
	}

	bnext = bcopy = Asprintf("%.*s", (int)len, buf);
	while ((newline = strchr(bnext, '\n')) != NULL) {
	    json_array_append(result_array, json_string(bnext, newline - bnext));
	    json_array_append(err_array, json_boolean(!success));
	    bnext = newline + 1;
	}
	json_array_append(result_array, json_string(bnext, strlen(bnext)));
	json_array_append(err_array, json_boolean(!success));
	Free(bcopy);
    } else {
	/* Plain text. */
	vb_append(&s->pending.result, buf, len);
	vb_appends(&s->pending.result, "\n");
    }
}

/**
 * Completion callback from x3270 back to httpd.
 *
 * @param[in] handle	handle
 * @param[in] success	true if command succeeded
 * @param[in] abort	true if aborting
 *
 * @return True if the context is complete
 */
static bool
hio_complete(task_cbh handle, bool success, bool abort)
{
    session_t *s = handle;
    const char *prompt = task_cb_prompt(handle);

    /* We're done. */
    s->pending.done = true;

    /* Pass the result up to the node. */
    s->pending.callback(s->dhandle, success? SC_SUCCESS: SC_USER_ERROR,
	    vb_buf(&s->pending.result), vb_len(&s->pending.result),
	    s->pending.jresult, prompt, strlen(prompt));

    /* Get ready for the next command. */
    vb_reset(&s->pending.result);
    json_free(s->pending.jresult);

    /* This is always the end of the command. */
    return true;
}

/**
 * Get the content type for a request.
 *
 * @param[in] dhandle	state
 *
 * @return content_t
 */
content_t
hio_content_type(void *dhandle)
{
    session_t *s = httpd_mhandle(dhandle);

    return httpd_content_type(s->dhandle);
}

/**
 * Get the content for a request.
 *
 * @param[in] dhandle	state
 *
 * @return char *
 */
char *
hio_content(void *dhandle)
{
    session_t *s = httpd_mhandle(dhandle);

    return httpd_content(s->dhandle);
}

/**
 * Get the verb for a request.
 *
 * @param[in] dhandle	state
 *
 * @return Verb
 */
verb_t
hio_verb(void *dhandle)
{
    session_t *s = httpd_mhandle(dhandle);

    return httpd_verb(s->dhandle);
}

/**
 * Send a command to x3270.
 *
 * @param[in] cmd	command to send, not including the newline and
 * @param[in] callback	callback function for completion
 * @param[in] dhandle	handle to pass to completion callback function
 * @param[in] request_content_type	How to process input
 * @param[in] return_content_type	How to return content
 * @param[out] errmsg	error message, if SENDTO_INVALID returned
 *
 * @return sendto_t
 */
sendto_t
hio_to3270(const char *cmd, sendto_callback_t *callback, void *dhandle,
	content_t request_content_type, content_t return_content_type,
	char **errmsg)
{
    static tcb_t httpd_cb = {
	"httpd",
	IA_HTTPD,
	CB_NEW_TASKQ,
	hio_data,
	hio_complete,
	NULL
    };
    size_t sl;
    session_t *s = httpd_mhandle(dhandle);
    cmd_t **cmds = NULL;
    char *single = NULL;

    *errmsg = NULL;

    /* Remove any trailing white space. */
    sl = strlen(cmd);
    while (sl && isspace((int)cmd[sl - 1])) {
	sl--;
    }

    switch (request_content_type) {
    case CT_HTML:
    case CT_TEXT:
	/* Plain text. */
	break;
    case CT_JSON:
	/* JSON-encoded text. */
	if (hjson_parse(cmd, sl, &cmds, &single, errmsg) != HJ_OK) {
	    return SENDTO_INVALID;
	}
	break;
    default:
	*errmsg = NewString("Invalid content type");
	return SENDTO_INVALID;
    }

    /* Enqueue the command. */
    s->pending.callback = callback;
    s->pending.return_content_type = return_content_type;
    s->pending.done = false;
    if (cmds != NULL) {
	push_cb_split(cmds, &httpd_cb, s);
    } else {
	push_cb(single? single: cmd,
		single? strlen(single): sl,
		&httpd_cb, s);
	Free(single);
    }

    /*
     * It's possible for the command to have completed already.
     * If so, return SENDTO_COMPLETE.
     * Otherwise, it's just queued; return SENDTO_PENDING.
     */
    return s->pending.done? SENDTO_COMPLETE: SENDTO_PENDING;
}

/**
 * Asynchronous completion.
 *
 * @param[in] dhandle   State
 * @param[in] rv        Completion status
 */
void
hio_async_done(void *dhandle, httpd_status_t rv)
{
    session_t *session = httpd_mhandle(dhandle);

    if (rv < 0) {
	hio_socket_close(session);
	return;
    }

    /* Allow more input. */
    if (session->ioid == NULL_IOID) {
#if !defined(_WIN32) /*[*/
	session->ioid = AddInput(session->s, hio_socket_input);
#else /*][*/
	session->ioid = AddInput(session->event, hio_socket_input);
#endif /*]*/
    }

    /*
     * Set a timeout for that input to arrive. We didn't set this timeout
     * as soon as the last input arrived, because it might have taken us a
     * long time to proces the last request.
     */
    if (session->toid == NULL_IOID) {
	session->toid = AddTimeOut(IDLE_MAX * 1000, hio_timeout);
    }
}

/**
 * Upcall for toggling the global HTTP listener on and off.
 *
 * @param[in] name	Name of toggle
 * @param[in] value	Toggle value
 * @param[in] flags	Set() flags
 * @param[in] ia	Cause
 *
 * @returns toggle_upcall_ret_t
 */
static toggle_upcall_ret_t
hio_toggle_upcall(const char *name, const char *value, unsigned flags, ia_t ia)
{
    struct sockaddr *sa;
    socklen_t sa_len;

    hio_stop();
    if (value == NULL || !*value) {
	Replace(appres.httpd_port, NULL);
	return TU_SUCCESS;
    }

    if (!parse_bind_opt(value, &sa, &sa_len)) {
	popup_an_error("Invalid %s: %s", name, value);
	return TU_FAILURE;
    }
    Replace(appres.httpd_port, NewString(canonical_bind_opt(sa)));
    hio_init(sa, sa_len);
    return TU_SUCCESS;
}

/**
 * Register httpd with the rest of the system.
 */
void
hio_register(void)
{
    register_extended_toggle(ResHttpd, hio_toggle_upcall, NULL,
	    canonical_bind_opt_res, (void **)&appres.httpd_port, XRM_STRING);
}
