/*
 * Copyright (c) 2012 Tim Ruehsen
 * Copyright (c) 2015-2026 Free Software Foundation, Inc.
 *
 * This file is part of Wget.
 *
 * Wget is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Wget is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Wget.  If not, see <https://www.gnu.org/licenses/>.
 *
 *
 * Header file for HOST stuff
 *
 * Changelog
 * 10.09.2013  Tim Ruehsen  created
 *
 */

#ifndef SRC_WGET_HOST_H
#define SRC_WGET_HOST_H

#include <wget.h>
#include <stdbool.h>

struct JOB;
typedef struct JOB JOB;

// everything host/domain specific should go here
typedef struct {
	const char
		*host;
	JOB
		*robot_job; // special job for downloading robots.txt (before anything else)
	wget_robots
		*robots;
	wget_list
		*queue; // host specific job queue
	long long
		retry_ts; // timestamp of earliest retry in milliseconds
	int
		qsize, // number of jobs in queue
		failures; // number of consequent connection failures
	wget_iri_scheme
		scheme;
	uint16_t
		port;
	bool
		blocked : 1; // host may be blocked after too many errors or even one final error
} HOST;

void host_init(void);
void host_exit(void);

HOST *host_add(const wget_iri *iri) WGET_GCC_NONNULL((1));
HOST *host_get(const wget_iri *iri) WGET_GCC_NONNULL((1));

JOB *host_get_job(HOST *host, long long *pause);
void host_add_job(HOST *host, const JOB *job) WGET_GCC_NONNULL((1,2));
void host_add_robotstxt_job(HOST *host, const wget_iri *iri, const char *encoding, bool http_fallback) WGET_GCC_NONNULL((1,2));
void host_release_jobs(HOST *host);
void host_remove_job(HOST *host, JOB *job) WGET_GCC_NONNULL((1,2));
void host_queue_free(HOST *host) WGET_GCC_NONNULL((1));
void hosts_free(void);
void host_increase_failure(HOST *host) WGET_GCC_NONNULL((1));
void host_final_failure(HOST *host) WGET_GCC_NONNULL((1));
void host_reset_failure(HOST *host) WGET_GCC_NONNULL((1));

int queue_size(void) WGET_GCC_PURE;
int queue_empty(void) WGET_GCC_PURE;
void queue_print(HOST *host);

#endif /* SRC_WGET_HOST_H */
