monojob.h File Reference

Single foreground job. More...

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
int	monojob_wait (const char *string, unsigned long timeout)
	Wait for single foreground job to complete. More...

Variables
struct interface	monojob

Detailed Description

Single foreground job.

Definition in file monojob.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

monojob_wait()

int monojob_wait	(	const char *	string,
		unsigned long	timeout
	)

Wait for single foreground job to complete.

Parameters

string	Job description to display, or NULL to be silent
timeout	Timeout period, in ticks (0=indefinite)

Return values

rc	Job final status code

Definition at line 81 of file monojob.c.

                                                               {
        struct job_progress progress;
        unsigned long last_check;
        unsigned long last_progress;
        unsigned long last_display;
        unsigned long now;
        unsigned long elapsed;
        unsigned long completed = 0;
        unsigned long scaled_completed;
        unsigned long scaled_total;
        unsigned int percentage;
        size_t clear_len = 0;
        int ongoing_rc;
        int key;
        int rc;

        if ( string )
                printf ( "%s...", string );
        monojob_rc = -EINPROGRESS;
        last_check = last_progress = last_display = currticks();
        while ( monojob_rc == -EINPROGRESS ) {

                /* Allow job to progress */
                step();
                now = currticks();

                /* Continue until a timer tick occurs (to minimise
                 * time wasted checking for progress and keypresses).
                 */
                elapsed = ( now - last_check );
                if ( ! elapsed )
                        continue;
                last_check = now;

                /* Check for keypresses */
                if ( iskey() ) {
                        key = getchar();
                        if ( key == CTRL_C ) {
                                monojob_rc = -ECANCELED;
                                break;
                        }
                }

                /* Monitor progress */
                ongoing_rc = job_progress ( &monojob, &progress );

                /* Reset timeout if progress has been made */
                if ( completed != progress.completed )
                        last_progress = now;
                completed = progress.completed;

                /* Check for timeout, if applicable */
                elapsed = ( now - last_progress );
                if ( timeout && ( elapsed >= timeout ) ) {
                        monojob_rc = ( ongoing_rc ? ongoing_rc : -ETIMEDOUT );
                        break;
                }

                /* Display progress, if applicable */
                elapsed = ( now - last_display );
                if ( string && ( elapsed >= TICKS_PER_SEC ) ) {
                        monojob_clear ( clear_len );
                        /* Normalise progress figures to avoid overflow */
                        scaled_completed = ( progress.completed / 128 );
                        scaled_total = ( progress.total / 128 );
                        if ( scaled_total ) {
                                percentage = ( ( 100 * scaled_completed ) /
                                               scaled_total );
                                clear_len = printf ( "%3d%%", percentage );
                        } else {
                                printf ( "." );
                                clear_len = 0;
                        }
                        if ( progress.message[0] ) {
                                clear_len += printf ( " [%s]",
                                                      progress.message );
                        }
                        last_display = now;
                }
        }
        rc = monojob_rc;
        monojob_close ( &monojob, rc );

        monojob_clear ( clear_len );
        if ( string ) {
                if ( rc ) {
                        printf ( " %s\n", strerror ( rc ) );
                } else {
                        printf ( " ok\n" );
                }
        }

        return rc;
}

References job_progress::completed, CTRL_C, currticks(), ECANCELED, EINPROGRESS, ETIMEDOUT, getchar(), iskey(), job_progress(), key, job_progress::message, monojob, monojob_clear(), monojob_close(), monojob_rc, printf(), rc, step(), strerror(), TICKS_PER_SEC, timeout(), and job_progress::total.

Referenced by fcels(), ifpoller_wait(), imgdownload(), imgverify(), nslookup(), ntp(), ping(), pxebs(), and sync().

Variable Documentation

monojob

struct interface monojob

Definition at line 56 of file monojob.c.

Referenced by fcels(), ifpoller_wait(), imgdownload(), imgverify(), monojob_wait(), nslookup(), ntp(), ping(), pxebs(), and sync().