unistd.h File Reference

#include <stddef.h>
#include <stdarg.h>
#include <ipxe/timer.h>

Go to the source code of this file.

Macros
#define	execl(command, arg, ...)
	Execute command. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
int	execv (const char *command, char *const argv[])
	Execute command. More...
static __always_inline void	usleep (unsigned long usecs)

Macro Definition Documentation

execl

#define execl	(		command,
			arg,
			...
	)

Value:

( {                                     \
                char * const argv[] = { (arg), ## __VA_ARGS__ };        \
                int rc = execv ( (command), argv );                     \
                rc;                                                     \
        } )

Execute command.

Parameters

command	Command name
arg	... Argument list (starting with argv[0])

Return values

rc	Command exit status

This is a front end to execv().

Definition at line 21 of file unistd.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

execv()

int execv	(	const char *	command,
		char *const	argv[]
	)

Execute command.

Parameters

command	Command name
argv	Argument list

Return values

rc	Return status code

Execute the named command. Unlike a traditional POSIX execv(), this function returns the exit status of the command.

Definition at line 61 of file exec.c.

                                                       {
        struct command *cmd;
        int argc;
        int rc;

        /* Count number of arguments */
        for ( argc = 0 ; argv[argc] ; argc++ ) {}

        /* An empty command is deemed to do nothing, successfully */
        if ( command == NULL ) {
                rc = 0;
                goto done;
        }

        /* Sanity checks */
        if ( argc == 0 ) {
                DBG ( "%s: empty argument list\n", command );
                rc = -EINVAL;
                goto done;
        }

        /* Reset getopt() library ready for use by the command.  This
         * is an artefact of the POSIX getopt() API within the context
         * of Etherboot; see the documentation for reset_getopt() for
         * details.
         */
        reset_getopt();

        /* Hand off to command implementation */
        for_each_table_entry ( cmd, COMMANDS ) {
                if ( strcmp ( command, cmd->name ) == 0 ) {
                        rc = cmd->exec ( argc, ( char ** ) argv );
                        goto done;
                }
        }

        printf ( "%s: command not found\n", command );
        rc = -ENOEXEC;

 done:
        /* Store error number, if an error occurred */
        if ( rc ) {
                errno = rc;
                if ( errno < 0 )
                        errno = -errno;
        }

        return rc;
}

References cmd, COMMANDS, DBG, done, EINVAL, ENOEXEC, errno, for_each_table_entry, NULL, printf(), rc, reset_getopt(), and strcmp().

Referenced by system(), and time_exec().

usleep()

static __always_inline void usleep ( unsigned long  usecs )

inlinestatic

Definition at line 30 of file unistd.h.

                                                                  {
        udelay ( usecs );
}

References udelay().