ERRORS

Other errors may occur.

EACCESS	Permission to write the file is denied.
ENOENT	filename does not exist.

CONFORMS TO

utime: SVID, POSIX utimes:BSD4.3

SEE ALSO

stat(2)

Linux, 10 June 1995

vhangup

vhangup—Virtually hangs up the current tty

SYPNOSIS

#include <unistd.h>
int vhangup(void);

DESCRIPTION

vhangup simulates a hangup on the current terminal. This call arranges for other users to have a clean tty at login time.

RETURN VALUE

On success, 0 is returned. On error, _1 is returned, and errno is set appropriately.

ERRORS

SEE ALSO

init(8)

Linux 0.99.11, 24 July 1993

vm86

vm86—Enters virtual 8086 mode

SYPNOSIS

#include <sys/vm86.h>
int vm86(struct vm86_struct * info);

DESCRIPTION

Enter VM86 mode with information as specified in info:

struct vm86_struct {
        struct vm86_regs regs;
        unsigned long flags;

        unsigned long screen_bitmap;
};

waistruct vm86_regs {
/*
 * normal regs, with special meaning for the segment descriptors..
 */
        long ebx;
        long ecx;
        long edx;
        long esi;
        long edi;
        long ebp;
        long eax;
        long __null_ds;
        long __null_es;
        long __null_fs;
        long __null_gs;
        long orig_eax;
        long eip;
        long cs;
        long eflags;
        long esp;
        long ss;
/*
 * these are specific to v86 mode:
 */
        long es;
        long ds;
        long fs;
        long gs;
};

these are specific to v86 mode:

/
long es;
long ds;
long fs;
long gs;
};

RETURN VALUE

On success, 0 is returned. On error, _1 is returned, and errno is set appropriately.

ERRORS

Linux 0.99.11, 24 July 1993

wait, waitpid

wait, waitpid—Wait for process termination

SYPNOSIS

#include <sys/types.h>
#include <sys/wait.h>

pid_t wait(int *status)
pid_t waitpid(pid_t pid,int*status,int options);

DESCRIPTION

The wait function suspends execution of the current process until a child has exited, or until a signal is delivered whose action is to terminate the current process or to call a signal-handling function. If a child has already exited by the time of the call (a so_called zombie process), the function returns immediately. Any system resources used by the child are freed.

The waitpid function suspends execution of the current process until a child as specified by the pid argument has exited, or until a signal is delivered whose action is to terminate the current process or to call a signal-handling function. Just as with wait, if a child requested by pid has already exited by the time of the call, the function returns immediately. Any system resources used by the child are freed.

The value of pid can be one of the following:

The value of options is an OR of zero or more of the following constants:

WNOHANG	Return immediately if no child has exited.
WUNTRACED	Also return for children that are stopped and whose status has not been reported.

If status is not NULL, wait or waitpid stores status information in the location pointed to by statloc.

This status can be evaluated with the following macros (these macros take the stat buffer as an argument—not a pointer to the buffer!):

RETURN VALUE

The process ID of the child that exited returns _1 on error or 0 if WNOHANG was used and no child was available (in which case errno is set to an appropriate value).

ERRORS