monojob.c File Reference

Single foreground job. More...

#include <string.h>
#include <stdio.h>
#include <errno.h>
#include <gpxe/process.h>
#include <console.h>
#include <gpxe/keys.h>
#include <gpxe/job.h>
#include <gpxe/monojob.h>
#include <gpxe/timer.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
static void	monojob_done (struct job_interface *job __unused, int rc)
int	monojob_wait (const char *string)
	Wait for single foreground job to complete.
Variables
static int	monojob_rc
static struct job_interface_operations	monojob_operations
	Single foreground job operations.
struct job_interface	monojob
	Single foreground job.

---

Detailed Description

Single foreground job.

Definition in file monojob.c.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

static void monojob_done	(	struct job_interface *job	__unused,
		int	rc
	)			[static]

Definition at line 39 of file monojob.c.

References monojob_rc.

                                                                        {
        monojob_rc = rc;
}

int monojob_wait

(

const char *

string

)

Wait for single foreground job to complete.

Parameters:

string

Job description to display

Return values:

rc

Job final status code

Definition at line 65 of file monojob.c.

References CTRL_C, currticks(), ECANCELED, EINPROGRESS, getchar(), iskey(), job_done(), job_kill(), monojob_rc, printf(), step(), strerror(), and TICKS_PER_SEC.

Referenced by dhcp(), imgfetch(), and pxebs().

                                        {
        int key;
        int rc;
        unsigned long last_progress_dot;
        unsigned long elapsed;

        printf ( "%s.", string );
        monojob_rc = -EINPROGRESS;
        last_progress_dot = currticks();
        while ( monojob_rc == -EINPROGRESS ) {
                step();
                if ( iskey() ) {
                        key = getchar();
                        switch ( key ) {
                        case CTRL_C:
                                job_kill ( &monojob );
                                rc = -ECANCELED;
                                goto done;
                        default:
                                break;
                        }
                }
                elapsed = ( currticks() - last_progress_dot );
                if ( elapsed >= TICKS_PER_SEC ) {
                        printf ( "." );
                        last_progress_dot = currticks();
                }
        }
        rc = monojob_rc;

done:
        job_done ( &monojob, rc );
        if ( rc ) {
                printf ( " %s\n", strerror ( rc ) );
        } else {
                printf ( " ok\n" );
        }
        return rc;
}

---

Variable Documentation

int monojob_rc [static]

Definition at line 37 of file monojob.c.

Referenced by monojob_done(), and monojob_wait().

struct job_interface_operations monojob_operations [static]

Initial value:

 {
        .done           = monojob_done,
        .kill           = ignore_job_kill,
        .progress       = ignore_job_progress,
}

Single foreground job operations.

Definition at line 44 of file monojob.c.

struct job_interface monojob

Initial value:

 {
        .intf = {
                .dest = &null_job.intf,
                .refcnt = NULL,
        },
        .op = &monojob_operations,
}

Single foreground job.

Definition at line 51 of file monojob.c.

Referenced by dhcp(), imgfetch(), and pxebs().