38379c5c5e07535f6a8934e6088f475534390405Brian Wellington/*
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews * Copyright (C) 2000, 2001, 2004, 2005, 2007, 2016 Internet Systems Consortium, Inc. ("ISC")
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington *
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews * This Source Code Form is subject to the terms of the Mozilla Public
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews * License, v. 2.0. If a copy of the MPL was not distributed with this
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews * file, You can obtain one at http://mozilla.org/MPL/2.0/.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
70e5a7403f0e0a3bd292b8287c5fed5772c15270Automatic Updater/* $Id: lwsearch.h,v 1.9 2007/06/19 23:46:59 tbox Exp $ */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#ifndef NAMED_LWSEARCH_H
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#define NAMED_LWSEARCH_H 1
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#include <isc/mutex.h>
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#include <isc/result.h>
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#include <isc/types.h>
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#include <dns/types.h>
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#include <named/types.h>
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*! \file
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein * \brief
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Lightweight resolver search list types and routines.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington *
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * An ns_lwsearchlist_t holds a list of search path elements.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington *
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * An ns_lwsearchctx stores the state of search list during a lookup
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * operation.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*% An ns_lwsearchlist_t holds a list of search path elements. */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonstruct ns_lwsearchlist {
28fc90e6c81338c5f34e065fdda49d320e362583Mark Andrews unsigned int magic;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington isc_mutex_t lock;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington isc_mem_t *mctx;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington unsigned int refs;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington dns_namelist_t names;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington};
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*% An ns_lwsearchctx stores the state of search list during a lookup operation. */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonstruct ns_lwsearchctx {
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington dns_name_t *relname;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington dns_name_t *searchname;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington unsigned int ndots;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington ns_lwsearchlist_t *list;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington isc_boolean_t doneexact;
eb716d8c2e4b19b2e68ea8d87da4635ea877b3cdBrian Wellington isc_boolean_t exactfirst;
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington};
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonisc_result_t
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchlist_create(isc_mem_t *mctx, ns_lwsearchlist_t **listp);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Create an empty search list object.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonvoid
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchlist_attach(ns_lwsearchlist_t *source, ns_lwsearchlist_t **target);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Attach to a search list object.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonvoid
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchlist_detach(ns_lwsearchlist_t **listp);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Detach from a search list object.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonisc_result_t
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchlist_append(ns_lwsearchlist_t *list, dns_name_t *name);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Append an element to a search list. This creates a copy of the name.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonvoid
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchctx_init(ns_lwsearchctx_t *sctx, ns_lwsearchlist_t *list,
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington dns_name_t *name, unsigned int ndots);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Creates a search list context structure.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonvoid
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchctx_first(ns_lwsearchctx_t *sctx);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Moves the search list context iterator to the first element, which
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * is usually the exact name.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonisc_result_t
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchctx_next(ns_lwsearchctx_t *sctx);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Moves the search list context iterator to the next element.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonisc_result_t
38379c5c5e07535f6a8934e6088f475534390405Brian Wellingtonns_lwsearchctx_current(ns_lwsearchctx_t *sctx, dns_name_t *absname);
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein/*%<
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * Obtains the current name to be looked up. This involves either
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * concatenating the name with a search path element, making an
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington * exact name absolute, or doing nothing.
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington */
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington
38379c5c5e07535f6a8934e6088f475534390405Brian Wellington#endif /* NAMED_LWSEARCH_H */