resolv.h File Reference

Name resolution. More...

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

Go to the source code of this file.

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

Macros
#define	RESOLV_NUMERIC   01
	Numeric resolver priority.
#define	RESOLV_NORMAL   02
	Normal resolver priority.
#define	RESOLVERS   __table ( struct resolver, "resolvers" )
	Resolvers table.
#define	__resolver(resolv_order)
	Register as a name resolver.
#define	resolv_done_TYPE(object_type)

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
void	resolv_done (struct interface *intf, struct sockaddr *sa)
	Name resolved.
int	resolv (struct interface *resolv, const char *name, struct sockaddr *sa)
	Start name resolution.

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.

Referenced by __resolver().

RESOLV_NORMAL

#define RESOLV_NORMAL   02

Normal resolver priority.

Definition at line 37 of file resolv.h.

Referenced by __resolver().

RESOLVERS

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

Resolvers table.

Definition at line 40 of file resolv.h.

Referenced by resmux_child_close(), and resolv().

__resolver

#define __resolver

(

resolv_order

)

Value:

__table_entry ( RESOLVERS, resolv_order )

Register as a name resolver.

Definition at line 43 of file resolv.h.

Referenced by __resolver(), and __resolver().

resolv_done_TYPE

#define resolv_done_TYPE

(

object_type

)

Value:

        typeof ( void ( object_type, struct sockaddr *sa ) )

Definition at line 46 of file resolv.h.

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

Referenced by resolv_done().

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 )

extern

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 )

extern

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(), name, resolv_mux::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().