downloader.h File Reference

Image downloader. More...

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
int	create_downloader (struct job_interface *job, struct image *image, int(*register_image)(struct image *image), int type,...)
	Instantiate a downloader.

---

Detailed Description

Image downloader.

Definition in file downloader.h.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

int create_downloader	(	struct job_interface *	job,
		struct image *	image,
		int(*)(struct image *image)	register_image,
		int	type,
			...
	)

Instantiate a downloader.

Parameters:

	job	Job control interface
	image	Image to fill with downloaded file
	register_image	Image registration routine
	type	Location type to pass to xfer_open()
	...	Remaining arguments to pass to xfer_open()

Return values:

rc

Return status code

Instantiates a downloader object to download the specified URI into the specified image object. If the download is successful, the image registration routine register_image() will be called.

Definition at line 256 of file downloader.c.

References downloader_finished(), downloader_free(), ENOMEM, refcnt::free, downloader::image, image_get(), downloader::job, job_init(), job_plug_plug(), ref_put(), downloader::refcnt, register_image(), downloader::register_image, va_end, va_start, downloader::xfer, xfer_init(), xfer_vopen(), and zalloc().

Referenced by imgfetch().

                                        {
        struct downloader *downloader;
        va_list args;
        int rc;

        /* Allocate and initialise structure */
        downloader = zalloc ( sizeof ( *downloader ) );
        if ( ! downloader )
                return -ENOMEM;
        downloader->refcnt.free = downloader_free;
        job_init ( &downloader->job, &downloader_job_operations,
                   &downloader->refcnt );
        xfer_init ( &downloader->xfer, &downloader_xfer_operations,
                    &downloader->refcnt );
        downloader->image = image_get ( image );
        downloader->register_image = register_image;
        va_start ( args, type );

        /* Instantiate child objects and attach to our interfaces */
        if ( ( rc = xfer_vopen ( &downloader->xfer, type, args ) ) != 0 )
                goto err;

        /* Attach parent interface, mortalise self, and return */
        job_plug_plug ( &downloader->job, job );
        ref_put ( &downloader->refcnt );
        va_end ( args );
        return 0;

 err:
        downloader_finished ( downloader, rc );
        ref_put ( &downloader->refcnt );
        va_end ( args );
        return rc;
}