190 lines
5.4 KiB
C
190 lines
5.4 KiB
C
/* syscalls.h
|
|
* Nachos system call interface. These are Nachos kernel operations
|
|
* that can be invoked from user programs, by trapping to the kernel
|
|
* via the "syscall" instruction.
|
|
*
|
|
* This file is included by user programs and by the Nachos kernel.
|
|
*
|
|
* Copyright (c) 1992-1993 The Regents of the University of California.
|
|
* All rights reserved. See copyright.h for copyright notice and limitation
|
|
* of liability and disclaimer of warranty provisions.
|
|
*/
|
|
|
|
#ifndef SYSCALLS_H
|
|
#define SYSCALLS_H
|
|
|
|
#include "copyright.h"
|
|
#include "errno.h"
|
|
/* system call codes -- used by the stubs to tell the kernel which system call
|
|
* is being asked for
|
|
*/
|
|
#define SC_Halt 0
|
|
#define SC_Exit 1
|
|
#define SC_Exec 2
|
|
#define SC_Join 3
|
|
#define SC_Create 4
|
|
#define SC_Remove 5
|
|
#define SC_Open 6
|
|
#define SC_Read 7
|
|
#define SC_Write 8
|
|
#define SC_Seek 9
|
|
#define SC_Close 10
|
|
#define SC_ThreadFork 11
|
|
#define SC_ThreadYield 12
|
|
#define SC_ExecV 13
|
|
#define SC_ThreadExit 14
|
|
#define SC_ThreadJoin 15
|
|
#define SC_Add 42
|
|
#define SC_MSG 100
|
|
#define SC_PrintInt 16
|
|
|
|
#ifndef IN_ASM
|
|
|
|
/* The system call interface. These are the operations the Nachos
|
|
* kernel needs to support, to be able to run user programs.
|
|
*
|
|
* Each of these is invoked by a user program by simply calling the
|
|
* procedure; an assembly language stub stuffs the system call code
|
|
* into a register, and traps to the kernel. The kernel procedures
|
|
* are then invoked in the Nachos kernel, after appropriate error checking,
|
|
* from the system call entry point in exception.cc.
|
|
*/
|
|
|
|
/* Stop Nachos, and print out performance stats */
|
|
void Halt();
|
|
|
|
/*
|
|
* Show the int value on console
|
|
*/
|
|
void PrintInt(int value);
|
|
|
|
/*
|
|
* Add the two operants and return the result
|
|
*/
|
|
|
|
int Add(int op1, int op2);
|
|
/*
|
|
* Just for simply showing message, not a safe way for console IO
|
|
*/
|
|
void MSG(char* msg);
|
|
|
|
/* Address space control operations: Exit, Exec, Execv, and Join */
|
|
|
|
/* This user program is done (status = 0 means exited normally). */
|
|
void Exit(int status);
|
|
|
|
/* A unique identifier for an executing user program (address space) */
|
|
typedef int SpaceId;
|
|
|
|
/* A unique identifier for a thread within a task */
|
|
typedef int ThreadId;
|
|
|
|
/* Run the specified executable, with no args */
|
|
/* This can be implemented as a call to ExecV.
|
|
*/
|
|
SpaceId Exec(char* exec_name);
|
|
|
|
/* Run the executable, stored in the Nachos file "argv[0]", with
|
|
* parameters stored in argv[1..argc-1] and return the
|
|
* address space identifier
|
|
*/
|
|
SpaceId ExecV(int argc, char* argv[]);
|
|
|
|
/* Only return once the user program "id" has finished.
|
|
* Return the exit status.
|
|
*/
|
|
int Join(SpaceId id);
|
|
|
|
|
|
/* File system operations: Create, Remove, Open, Read, Write, Close
|
|
* These functions are patterned after UNIX -- files represent
|
|
* both files *and* hardware I/O devices.
|
|
*
|
|
* Note that the Nachos file system has a stub implementation, which
|
|
* can be used to support these system calls if the regular Nachos
|
|
* file system has not been implemented.
|
|
*/
|
|
|
|
/* A unique identifier for an open Nachos file. */
|
|
typedef int OpenFileId;
|
|
|
|
/* when an address space starts up, it has two open files, representing
|
|
* keyboard input and display output (in UNIX terms, stdin and stdout).
|
|
* Read and Write can be used directly on these, without first opening
|
|
* the console device.
|
|
*/
|
|
|
|
#define SysConsoleInput 0
|
|
#define SysConsoleOutput 1
|
|
|
|
/* Create a Nachos file, with name "name" */
|
|
/* Note: Create does not open the file. */
|
|
/* Return 1 on success, negative error code on failure */
|
|
int Create(char* name);
|
|
|
|
/* Remove a Nachos file, with name "name" */
|
|
int Remove(char* name);
|
|
|
|
/* Open the Nachos file "name", and return an "OpenFileId" that can
|
|
* be used to read and write to the file.
|
|
*/
|
|
OpenFileId Open(char* name);
|
|
|
|
/* Write "size" bytes from "buffer" to the open file.
|
|
* Return the number of bytes actually read on success.
|
|
* On failure, a negative error code is returned.
|
|
*/
|
|
int Write(char* buffer, int size, OpenFileId id);
|
|
|
|
/* Read "size" bytes from the open file into "buffer".
|
|
* Return the number of bytes actually read -- if the open file isn't
|
|
* long enough, or if it is an I/O device, and there aren't enough
|
|
* characters to read, return whatever is available (for I/O devices,
|
|
* you should always wait until you can return at least one character).
|
|
*/
|
|
int Read(char* buffer, int size, OpenFileId id);
|
|
|
|
/* Set the seek position of the open file "id"
|
|
* to the byte "position".
|
|
*/
|
|
int Seek(int position, OpenFileId id);
|
|
|
|
/* Close the file, we're done reading and writing to it.
|
|
* Return 1 on success, negative error code on failure
|
|
*/
|
|
int Close(OpenFileId id);
|
|
|
|
|
|
/* User-level thread operations: Fork and Yield. To allow multiple
|
|
* threads to run within a user program.
|
|
*
|
|
* Could define other operations, such as LockAcquire, LockRelease, etc.
|
|
*/
|
|
|
|
/* Fork a thread to run a procedure ("func") in the *same* address space
|
|
* as the current thread.
|
|
* Return a positive ThreadId on success, negative error code on failure
|
|
*/
|
|
ThreadId ThreadFork(void (*func)());
|
|
|
|
/* Yield the CPU to another runnable thread, whether in this address space
|
|
* or not.
|
|
*/
|
|
void ThreadYield();
|
|
|
|
/*
|
|
* Blocks current thread until lokal thread ThreadID exits with ThreadExit.
|
|
* Function returns the ExitCode of ThreadExit() of the exiting thread.
|
|
*/
|
|
int ThreadJoin(ThreadId id);
|
|
|
|
/*
|
|
* Deletes current thread and returns ExitCode to every waiting lokal thread.
|
|
*/
|
|
void ThreadExit(int ExitCode);
|
|
|
|
#endif /* IN_ASM */
|
|
|
|
#endif /* SYSCALL_H */
|
|
|