Name resolution. More...

#include <ipxe/interface.h>
#include <ipxe/tables.h>

Data Structures
struct	resolver
	A name resolver. More...

Macros
#define	RESOLV_NUMERIC 01
	Numeric resolver priority. More...

#define	RESOLV_NORMAL 02
	Normal resolver priority. More...

#define	RESOLVERS __table ( struct resolver, "resolvers" )
	Resolvers table. More...

#define	__resolver(resolv_order) __table_entry ( RESOLVERS, resolv_order )
	Register as a name resolver. More...

#define	resolv_done_TYPE(object_type) typeof ( void ( object_type, struct sockaddr *sa ) )

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)

	FILE_SECBOOT (PERMITTED)

void	resolv_done (struct interface intf, struct sockaddr sa)
	Name resolved. More...

int	resolv (struct interface resolv, const char name, struct sockaddr *sa)
	Start name resolution. More...

Detailed Description

Name resolution.

Definition in file resolv.h.

Macro Definition Documentation

◆ RESOLV_NUMERIC

#define RESOLV_NUMERIC 01

Numeric resolver priority.

Definition at line 34 of file resolv.h.

◆ RESOLV_NORMAL

#define RESOLV_NORMAL 02

Normal resolver priority.

Definition at line 37 of file resolv.h.

◆ RESOLVERS

#define RESOLVERS __table ( struct resolver, "resolvers" )

Resolvers table.

Definition at line 40 of file resolv.h.

◆ __resolver

#define __resolver ( resolv_order ) __table_entry ( RESOLVERS, resolv_order )

Register as a name resolver.

Definition at line 43 of file resolv.h.

◆ resolv_done_TYPE

#define resolv_done_TYPE ( object_type ) typeof ( void ( object_type, struct sockaddr *sa ) )

Definition at line 46 of file resolv.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ resolv_done()

void resolv_done	(	struct interface *	intf,
		struct sockaddr *	sa
	)

Name resolved.

Parameters

intf	Object interface
sa	Completed socket address (if successful)

Definition at line 56 of file resolv.c.

                                                                  {
         struct interface *dest;
         resolv_done_TYPE ( void * ) *op =
                 intf_get_dest_op ( intf, resolv_done, &dest );
         void *object = intf_object ( dest );
 
         DBGC ( INTF_COL ( intf ), "INTF " INTF_INTF_FMT " resolv_done\n",
                INTF_INTF_DBG ( intf, dest ) );
 
         if ( op ) {
                 op ( object, sa );
         } else {
                 /* Default is to ignore resolutions */
         }
 
         intf_put ( dest );
 }

References DBGC, dest, interface::intf, INTF_COL, intf_get_dest_op, INTF_INTF_DBG, INTF_INTF_FMT, intf_object(), intf_put(), op, resolv_done(), resolv_done_TYPE, and sa.

Referenced by dns_resolved(), numeric_step(), and resolv_done().

◆ resolv()

int resolv	(	struct interface *	resolv,
		const char *	name,
		struct sockaddr *	sa
	)

Start name resolution.

Parameters

resolv	Name resolution interface
name	Name to resolve
sa	Socket address to complete

Return values

rc	Return status code

Definition at line 258 of file resolv.c.

                                    {
         struct resolv_mux *mux;
         size_t name_len = ( strlen ( name ) + 1 );
         int rc;
 
         /* Allocate and initialise structure */
         mux = zalloc ( sizeof ( *mux ) + name_len );
         if ( ! mux )
                 return -ENOMEM;
         ref_init ( &mux->refcnt, NULL );
         intf_init ( &mux->parent, &resmux_parent_desc, &mux->refcnt );
         intf_init ( &mux->child, &resmux_child_desc, &mux->refcnt );
         mux->resolver = table_start ( RESOLVERS );
         if ( sa )
                 memcpy ( &mux->sa, sa, sizeof ( mux->sa ) );
         memcpy ( mux->name, name, name_len );
 
         DBGC ( mux, "RESOLV %p attempting to resolve \"%s\"\n", mux, name );
 
         /* Start first resolver in chain.  There will always be at
          * least one resolver (the numeric resolver), so no need to
          * check for the zero-resolvers-available case.
          */
         if ( ( rc = resmux_try ( mux ) ) != 0 )
                 goto err;
 
         /* Attach parent interface, mortalise self, and return */
         intf_plug_plug ( &mux->parent, resolv );
         ref_put ( &mux->refcnt );
         return 0;
 
  err:
         ref_put ( &mux->refcnt );
         return rc;      
 }

References resolv_mux::child, DBGC, ENOMEM, intf_init(), intf_plug_plug(), memcpy(), resolv_mux::name, name, NULL, resolv_mux::parent, rc, ref_init, ref_put, resolv_mux::refcnt, resmux_child_desc, resmux_parent_desc, resmux_try(), resolv(), resolv_mux::resolver, RESOLVERS, resolv_mux::sa, sa, strlen(), table_start, and zalloc().

Referenced by comboot_resolv(), dns_resolv(), numeric_resolv(), resolv(), resolv_setting(), and xfer_open_named_socket().

Data Structures

Macros

Functions