include/minix/syslib.h

   1 /* Prototypes for system library functions. */
   2
   3 #ifndef _SYSLIB_H
   4 #define _SYSLIB_H
   5
   6 #ifndef _TYPES_H
   7 #include <sys/types.h>
   8 #endif
   9
  10 #ifndef _IPC_H
  11 #include <minix/ipc.h>
  12 #endif
  13
  14 #include <minix/u64.h>
  15
  16 #ifndef _DEVIO_H
  17 #include <minix/devio.h>
  18 #endif
  19
  20 #include <minix/safecopies.h>
  21
  22 /* Forward declaration */
  23 struct reg86u;
  24 struct rs_pci;
  25
  26 #define SYSTASK SYSTEM
  27
  28 /*==========================================================================*
  29  * Minix system library.                                                    *
  30  *==========================================================================*/
  31 _PROTOTYPE( int _taskcall, (int who, int syscallnr, message *msgptr));
  32
  33 _PROTOTYPE( int sys_abort, (int how, ...));
  34 _PROTOTYPE( int sys_enable_iop, (endpoint_t proc));
  35 _PROTOTYPE( int sys_exec, (endpoint_t proc, char *ptr,
  36                                 char *aout, vir_bytes initpc));
  37 _PROTOTYPE( int sys_fork, (int parent, int child, int *, struct mem_map *ptr));
  38 _PROTOTYPE( int sys_newmap, (endpoint_t proc, struct mem_map *ptr));
  39 _PROTOTYPE( int sys_exit, (endpoint_t proc));
  40 _PROTOTYPE( int sys_trace, (int req, endpoint_t proc, long addr, long *data_p));
  41
  42 _PROTOTYPE( int sys_privctl, (endpoint_t proc, int req, int i, void *p));
  43 _PROTOTYPE( int sys_setgrant, (cp_grant_t *grants, int ngrants));
  44 _PROTOTYPE( int sys_nice, (endpoint_t proc, int priority));
  45
  46 _PROTOTYPE( int sys_int86, (struct reg86u *reg86p));
  47 _PROTOTYPE( int sys_vm_setbuf, (phys_bytes base, phys_bytes size,
  48                                                         phys_bytes high));
  49 _PROTOTYPE( int sys_vm_map, (endpoint_t proc_nr, int do_map,
  50         phys_bytes base, phys_bytes size, phys_bytes offset));
  51
  52 _PROTOTYPE( int sys_readbios, (phys_bytes address, void *buf, size_t size));
  53
  54 /* Shorthands for sys_sdevio() system call. */
  55 #define sys_insb(port, proc_nr, buffer, count) \
  56   sys_sdevio(DIO_INPUT_BYTE, port, proc_nr, buffer, count, 0)
  57 #define sys_insw(port, proc_nr, buffer, count) \
  58   sys_sdevio(DIO_INPUT_WORD, port, proc_nr, buffer, count, 0)
  59 #define sys_outsb(port, proc_nr, buffer, count) \
  60   sys_sdevio(DIO_OUTPUT_BYTE, port, proc_nr, buffer, count, 0)
  61 #define sys_outsw(port, proc_nr, buffer, count) \
  62   sys_sdevio(DIO_OUTPUT_WORD, port, proc_nr, buffer, count, 0)
  63 #define sys_safe_insb(port, ept, grant, offset, count) \
  64   sys_sdevio(DIO_SAFE_INPUT_BYTE, port, ept, (void*)grant, count, offset)
  65 #define sys_safe_outsb(port, ept, grant, offset, count) \
  66   sys_sdevio(DIO_SAFE_OUTPUT_BYTE, port, ept, (void*)grant, count, offset)
  67 #define sys_safe_insw(port, ept, grant, offset, count) \
  68   sys_sdevio(DIO_SAFE_INPUT_WORD, port, ept, (void*)grant, count, offset)
  69 #define sys_safe_outsw(port, ept, grant, offset, count) \
  70   sys_sdevio(DIO_SAFE_OUTPUT_WORD, port, ept, (void*)grant, count, offset)
  71 _PROTOTYPE( int sys_sdevio, (int req, long port, endpoint_t proc_nr,
  72         void *buffer, int count, vir_bytes offset));
  73
  74 /* Clock functionality: get system times or (un)schedule an alarm call. */
  75 _PROTOTYPE( int sys_times, (endpoint_t proc_nr, clock_t *ptr));
  76 _PROTOTYPE(int sys_setalarm, (clock_t exp_time, int abs_time));
  77
  78 /* Shorthands for sys_irqctl() system call. */
  79 #define sys_irqdisable(hook_id) \
  80     sys_irqctl(IRQ_DISABLE, 0, 0, hook_id)
  81 #define sys_irqenable(hook_id) \
  82     sys_irqctl(IRQ_ENABLE, 0, 0, hook_id)
  83 #define sys_irqsetpolicy(irq_vec, policy, hook_id) \
  84     sys_irqctl(IRQ_SETPOLICY, irq_vec, policy, hook_id)
  85 #define sys_irqrmpolicy(irq_vec, hook_id) \
  86     sys_irqctl(IRQ_RMPOLICY, irq_vec, 0, hook_id)
  87 _PROTOTYPE ( int sys_irqctl, (int request, int irq_vec, int policy,
  88     int *irq_hook_id) );
  89
  90 /* Shorthands for sys_vircopy() and sys_physcopy() system calls. */
  91 #define sys_biosin(bios_vir, dst_vir, bytes) \
  92         sys_vircopy(SELF, BIOS_SEG, bios_vir, SELF, D, dst_vir, bytes)
  93 #define sys_biosout(src_vir, bios_vir, bytes) \
  94         sys_vircopy(SELF, D, src_vir, SELF, BIOS_SEG, bios_vir, bytes)
  95 #define sys_datacopy(src_proc, src_vir, dst_proc, dst_vir, bytes) \
  96         sys_vircopy(src_proc, D, src_vir, dst_proc, D, dst_vir, bytes)
  97 #define sys_textcopy(src_proc, src_vir, dst_proc, dst_vir, bytes) \
  98         sys_vircopy(src_proc, T, src_vir, dst_proc, T, dst_vir, bytes)
  99 #define sys_stackcopy(src_proc, src_vir, dst_proc, dst_vir, bytes) \
 100         sys_vircopy(src_proc, S, src_vir, dst_proc, S, dst_vir, bytes)
 101 _PROTOTYPE(int sys_vircopy, (endpoint_t src_proc, int src_s, vir_bytes src_v,
 102         endpoint_t dst_proc, int dst_seg, vir_bytes dst_vir, phys_bytes bytes));
 103
 104 #define sys_abscopy(src_phys, dst_phys, bytes) \
 105         sys_physcopy(NONE, PHYS_SEG, src_phys, NONE, PHYS_SEG, dst_phys, bytes)
 106 _PROTOTYPE(int sys_physcopy, (endpoint_t src_proc, int src_seg, vir_bytes src_vir,
 107         endpoint_t dst_proc, int dst_seg, vir_bytes dst_vir, phys_bytes bytes));
 108
 109
 110 /* Grant-based copy functions. */
 111 _PROTOTYPE(int sys_safecopyfrom, (endpoint_t source, cp_grant_id_t grant,
 112         vir_bytes grant_offset, vir_bytes my_address, size_t bytes, int my_seg));
 113 _PROTOTYPE(int sys_safecopyto, (endpoint_t dest, cp_grant_id_t grant,
 114         vir_bytes grant_offset, vir_bytes my_address, size_t bytes, int my_seg));
 115 _PROTOTYPE(int sys_vsafecopy, (struct vscp_vec *copyvec, int elements));
 116
 117 _PROTOTYPE(int sys_memset, (unsigned long pattern,
 118                 phys_bytes base, phys_bytes bytes));
 119
 120
 121 /* Vectored virtual / physical copy calls. */
 122 #if DEAD_CODE           /* library part not yet implemented */
 123 _PROTOTYPE(int sys_virvcopy, (phys_cp_req *vec_ptr,int vec_size,int *nr_ok));
 124 _PROTOTYPE(int sys_physvcopy, (phys_cp_req *vec_ptr,int vec_size,int *nr_ok));
 125 #endif
 126
 127 _PROTOTYPE(int sys_umap, (endpoint_t proc_nr, int seg, vir_bytes vir_addr,
 128          vir_bytes bytes, phys_bytes *phys_addr));
 129 _PROTOTYPE(int sys_segctl, (int *index, u16_t *seg, vir_bytes *off,
 130         phys_bytes phys, vir_bytes size));
 131
 132 /* Shorthands for sys_getinfo() system call. */
 133 #define sys_getkmessages(dst)   sys_getinfo(GET_KMESSAGES, dst, 0,0,0)
 134 #define sys_getkinfo(dst)       sys_getinfo(GET_KINFO, dst, 0,0,0)
 135 #define sys_getloadinfo(dst)    sys_getinfo(GET_LOADINFO, dst, 0,0,0)
 136 #define sys_getmachine(dst)     sys_getinfo(GET_MACHINE, dst, 0,0,0)
 137 #define sys_getproctab(dst)     sys_getinfo(GET_PROCTAB, dst, 0,0,0)
 138 #define sys_getprivtab(dst)     sys_getinfo(GET_PRIVTAB, dst, 0,0,0)
 139 #define sys_getproc(dst,nr)     sys_getinfo(GET_PROC, dst, 0,0, nr)
 140 #define sys_getrandomness(dst)  sys_getinfo(GET_RANDOMNESS, dst, 0,0,0)
 141 #define sys_getimage(dst)       sys_getinfo(GET_IMAGE, dst, 0,0,0)
 142 #define sys_getirqhooks(dst)    sys_getinfo(GET_IRQHOOKS, dst, 0,0,0)
 143 #define sys_getirqactids(dst)   sys_getinfo(GET_IRQACTIDS, dst, 0,0,0)
 144 #define sys_getmonparams(v,vl)  sys_getinfo(GET_MONPARAMS, v,vl, 0,0)
 145 #define sys_getschedinfo(v1,v2) sys_getinfo(GET_SCHEDINFO, v1,0, v2,0)
 146 #define sys_getlocktimings(dst) sys_getinfo(GET_LOCKTIMING, dst, 0,0,0)
 147 #define sys_getbiosbuffer(virp, sizep) \
 148         sys_getinfo(GET_BIOSBUFFER, virp, sizeof(*virp), sizep, sizeof(*sizep))
 149 _PROTOTYPE(int sys_getinfo, (int request, void *val_ptr, int val_len,
 150                                  void *val_ptr2, int val_len2)          );
 151
 152 /* Signal control. */
 153 _PROTOTYPE(int sys_kill, (endpoint_t proc, int sig) );
 154 _PROTOTYPE(int sys_sigsend, (endpoint_t proc_nr, struct sigmsg *sig_ctxt) );
 155 _PROTOTYPE(int sys_sigreturn, (endpoint_t proc_nr, struct sigmsg *sig_ctxt) );
 156 _PROTOTYPE(int sys_getksig, (endpoint_t *k_proc_nr, sigset_t *k_sig_map) );
 157 _PROTOTYPE(int sys_endksig, (endpoint_t proc_nr) );
 158
 159 /* NOTE: two different approaches were used to distinguish the device I/O
 160  * types 'byte', 'word', 'long': the latter uses #define and results in a
 161  * smaller implementation, but looses the static type checking.
 162  */
 163 _PROTOTYPE(int sys_voutb, (pvb_pair_t *pvb_pairs, int nr_ports)         );
 164 _PROTOTYPE(int sys_voutw, (pvw_pair_t *pvw_pairs, int nr_ports)         );
 165 _PROTOTYPE(int sys_voutl, (pvl_pair_t *pvl_pairs, int nr_ports)         );
 166 _PROTOTYPE(int sys_vinb, (pvb_pair_t *pvb_pairs, int nr_ports)          );
 167 _PROTOTYPE(int sys_vinw, (pvw_pair_t *pvw_pairs, int nr_ports)          );
 168 _PROTOTYPE(int sys_vinl, (pvl_pair_t *pvl_pairs, int nr_ports)          );
 169
 170 /* Shorthands for sys_out() system call. */
 171 #define sys_outb(p,v)   sys_out((p), (unsigned long) (v), _DIO_BYTE)
 172 #define sys_outw(p,v)   sys_out((p), (unsigned long) (v), _DIO_WORD)
 173 #define sys_outl(p,v)   sys_out((p), (unsigned long) (v), _DIO_LONG)
 174 _PROTOTYPE(int sys_out, (int port, unsigned long value, int type)       );
 175
 176 /* Shorthands for sys_in() system call. */
 177 #define sys_inb(p,v)    sys_in((p), (v), _DIO_BYTE)
 178 #define sys_inw(p,v)    sys_in((p), (v), _DIO_WORD)
 179 #define sys_inl(p,v)    sys_in((p), (v), _DIO_LONG)
 180 _PROTOTYPE(int sys_in, (int port, unsigned long *value, int type)       );
 181
 182 /* pci.c */
 183 _PROTOTYPE( void pci_init, (void)                                       );
 184 _PROTOTYPE( void pci_init1, (char *name)                                );
 185 _PROTOTYPE( int pci_first_dev, (int *devindp, u16_t *vidp, u16_t *didp) );
 186 _PROTOTYPE( int pci_next_dev, (int *devindp, u16_t *vidp, u16_t *didp)  );
 187 _PROTOTYPE( int pci_find_dev, (U8_t bus, U8_t dev, U8_t func,
 188                                                         int *devindp)   );
 189 _PROTOTYPE( void pci_reserve, (int devind)                              );
 190 _PROTOTYPE( int pci_reserve_ok, (int devind)                            );
 191 _PROTOTYPE( void pci_ids, (int devind, u16_t *vidp, u16_t *didp)        );
 192 _PROTOTYPE( void pci_rescan_bus, (U8_t busnr)                           );
 193 _PROTOTYPE( u8_t pci_attr_r8, (int devind, int port)                    );
 194 _PROTOTYPE( u16_t pci_attr_r16, (int devind, int port)                  );
 195 _PROTOTYPE( u32_t pci_attr_r32, (int devind, int port)                  );
 196 _PROTOTYPE( void pci_attr_w8, (int devind, int port, U8_t value)        );
 197 _PROTOTYPE( void pci_attr_w16, (int devind, int port, U16_t value)      );
 198 _PROTOTYPE( void pci_attr_w32, (int devind, int port, u32_t value)      );
 199 _PROTOTYPE( char *pci_dev_name, (U16_t vid, U16_t did)                  );
 200 _PROTOTYPE( char *pci_slot_name, (int devind)                           );
 201 _PROTOTYPE( int pci_set_acl, (struct rs_pci *rs_pci)                    );
 202
 203 /* Profiling. */
 204 _PROTOTYPE( int sys_sprof, (int action, int size, int freq, int endpt,
 205                                        void *ctl_ptr, void *mem_ptr)   );
 206 _PROTOTYPE( int sys_cprof, (int action, int size, int endpt,
 207                                        void *ctl_ptr, void *mem_ptr)   );
 208 _PROTOTYPE( int sys_profbuf, (void *ctl_ptr, void *mem_ptr)            );
 209
 210 /* read_tsc() and friends. */
 211 _PROTOTYPE( void read_tsc_64, (u64_t *t)                                );
 212 _PROTOTYPE( void read_tsc, (u32_t *hi, u32_t *lo)                       );
 213
 214 #endif /* _SYSLIB_H */
 215