2018-09-25 09:22:51 -07:00
|
|
|
// Main public header file for our user-land support library,
|
|
|
|
|
// whose code lives in the lib directory.
|
|
|
|
|
// This library is roughly our OS's version of a standard C library,
|
|
|
|
|
// and is intended to be linked into all user-mode applications
|
|
|
|
|
// (NOT the kernel or boot loader).
|
|
|
|
|
|
|
|
|
|
#ifndef JOS_INC_LIB_H
|
|
|
|
|
#define JOS_INC_LIB_H 1
|
|
|
|
|
|
|
|
|
|
#include <inc/types.h>
|
|
|
|
|
#include <inc/stdio.h>
|
|
|
|
|
#include <inc/stdarg.h>
|
|
|
|
|
#include <inc/string.h>
|
|
|
|
|
#include <inc/error.h>
|
|
|
|
|
#include <inc/assert.h>
|
|
|
|
|
#include <inc/env.h>
|
|
|
|
|
#include <inc/memlayout.h>
|
|
|
|
|
#include <inc/syscall.h>
|
2018-10-06 06:52:47 -07:00
|
|
|
#include <inc/trap.h>
|
2018-09-25 09:22:51 -07:00
|
|
|
|
|
|
|
|
#define USED(x) (void)(x)
|
|
|
|
|
|
|
|
|
|
// main user program
|
|
|
|
|
void umain(int argc, char **argv);
|
|
|
|
|
|
|
|
|
|
// libmain.c or entry.S
|
|
|
|
|
extern const char *binaryname;
|
|
|
|
|
extern const volatile struct Env *thisenv;
|
|
|
|
|
extern const volatile struct Env envs[NENV];
|
|
|
|
|
extern const volatile struct PageInfo pages[];
|
|
|
|
|
|
|
|
|
|
// exit.c
|
|
|
|
|
void exit(void);
|
|
|
|
|
|
2018-10-06 06:52:47 -07:00
|
|
|
// pgfault.c
|
|
|
|
|
void set_pgfault_handler(void (*handler)(struct UTrapframe *utf));
|
|
|
|
|
|
2018-09-25 09:22:51 -07:00
|
|
|
// readline.c
|
|
|
|
|
char* readline(const char *buf);
|
|
|
|
|
|
|
|
|
|
// syscall.c
|
|
|
|
|
void sys_cputs(const char *string, size_t len);
|
|
|
|
|
int sys_cgetc(void);
|
|
|
|
|
envid_t sys_getenvid(void);
|
|
|
|
|
int sys_env_destroy(envid_t);
|
2018-10-06 06:52:47 -07:00
|
|
|
void sys_yield(void);
|
|
|
|
|
static envid_t sys_exofork(void);
|
|
|
|
|
int sys_env_set_status(envid_t env, int status);
|
|
|
|
|
int sys_env_set_pgfault_upcall(envid_t env, void *upcall);
|
|
|
|
|
int sys_page_alloc(envid_t env, void *pg, int perm);
|
|
|
|
|
int sys_page_map(envid_t src_env, void *src_pg,
|
|
|
|
|
envid_t dst_env, void *dst_pg, int perm);
|
|
|
|
|
int sys_page_unmap(envid_t env, void *pg);
|
|
|
|
|
int sys_ipc_try_send(envid_t to_env, uint32_t value, void *pg, int perm);
|
|
|
|
|
int sys_ipc_recv(void *rcv_pg);
|
|
|
|
|
|
|
|
|
|
// This must be inlined. Exercise for reader: why?
|
|
|
|
|
static inline envid_t __attribute__((always_inline))
|
|
|
|
|
sys_exofork(void)
|
|
|
|
|
{
|
|
|
|
|
envid_t ret;
|
|
|
|
|
asm volatile("int %2"
|
|
|
|
|
: "=a" (ret)
|
|
|
|
|
: "a" (SYS_exofork), "i" (T_SYSCALL));
|
|
|
|
|
return ret;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ipc.c
|
|
|
|
|
void ipc_send(envid_t to_env, uint32_t value, void *pg, int perm);
|
|
|
|
|
int32_t ipc_recv(envid_t *from_env_store, void *pg, int *perm_store);
|
|
|
|
|
envid_t ipc_find_env(enum EnvType type);
|
|
|
|
|
|
|
|
|
|
// fork.c
|
|
|
|
|
#define PTE_SHARE 0x400
|
|
|
|
|
envid_t fork(void);
|
|
|
|
|
envid_t sfork(void); // Challenge!
|
2018-09-25 09:22:51 -07:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* File open modes */
|
|
|
|
|
#define O_RDONLY 0x0000 /* open for reading only */
|
|
|
|
|
#define O_WRONLY 0x0001 /* open for writing only */
|
|
|
|
|
#define O_RDWR 0x0002 /* open for reading and writing */
|
|
|
|
|
#define O_ACCMODE 0x0003 /* mask for above modes */
|
|
|
|
|
|
|
|
|
|
#define O_CREAT 0x0100 /* create if nonexistent */
|
|
|
|
|
#define O_TRUNC 0x0200 /* truncate to zero length */
|
|
|
|
|
#define O_EXCL 0x0400 /* error if already exists */
|
|
|
|
|
#define O_MKDIR 0x0800 /* create directory, not regular file */
|
|
|
|
|
|
|
|
|
|
#endif // !JOS_INC_LIB_H
|
