scp.h

   1 /* scp.h: simulator control program headers
   2
   3    Copyright (c) 1993-2006, Robert M Supnik
   4
   5    Permission is hereby granted, free of charge, to any person obtaining a
   6    copy of this software and associated documentation files (the "Software"),
   7    to deal in the Software without restriction, including without limitation
   8    the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9    and/or sell copies of the Software, and to permit persons to whom the
  10    Software is furnished to do so, subject to the following conditions:
  11
  12    The above copyright notice and this permission notice shall be included in
  13    all copies or substantial portions of the Software.
  14
  15    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18    ROBERT M SUPNIK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  19    IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  20    CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  21
  22    Except as contained in this notice, the name of Robert M Supnik shall not
  23    be used in advertising or otherwise to promote the sale, use or other dealings
  24    in this Software without prior written authorization from Robert M Supnik.
  25
  26    09-Aug-06    JDB     Added assign_device and deassign_device
  27    14-Jul-06    RMS     Added sim_activate_abs
  28    06-Jan-06    RMS     Added fprint_stopped_gen
  29                         Changed arg type in sim_brk_test
  30    07-Feb-05    RMS     Added ASSERT command
  31    09-Sep-04    RMS     Added reset_all_p
  32    14-Feb-04    RMS     Added debug prototypes (from Dave Hittner)
  33    02-Jan-04    RMS     Split out from SCP
  34 */
  35
  36 #ifndef _SIM_SCP_H_
  37 #define _SIM_SCP_H_     0
  38
  39 /* run_cmd parameters */
  40
  41 #define RU_RUN          0                               /* run */
  42 #define RU_GO           1                               /* go */
  43 #define RU_STEP         2                               /* step */
  44 #define RU_CONT         3                               /* continue */
  45 #define RU_BOOT         4                               /* boot */
  46
  47 /* get_sim_opt parameters */
  48
  49 #define CMD_OPT_SW      001                             /* switches */
  50 #define CMD_OPT_OF      002                             /* output file */
  51 #define CMD_OPT_SCH     004                             /* search */
  52 #define CMD_OPT_DFT     010                             /* defaults */
  53
  54 /* Command processors */
  55
  56 t_stat reset_cmd (int32 flag, char *ptr);
  57 t_stat exdep_cmd (int32 flag, char *ptr);
  58 t_stat eval_cmd (int32 flag, char *ptr);
  59 t_stat load_cmd (int32 flag, char *ptr);
  60 t_stat run_cmd (int32 flag, char *ptr);
  61 t_stat attach_cmd (int32 flag, char *ptr);
  62 t_stat detach_cmd (int32 flag, char *ptr);
  63 t_stat assign_cmd (int32 flag, char *ptr);
  64 t_stat deassign_cmd (int32 flag, char *ptr);
  65 t_stat save_cmd (int32 flag, char *ptr);
  66 t_stat restore_cmd (int32 flag, char *ptr);
  67 t_stat exit_cmd (int32 flag, char *ptr);
  68 t_stat set_cmd (int32 flag, char *ptr);
  69 t_stat show_cmd (int32 flag, char *ptr);
  70 t_stat brk_cmd (int32 flag, char *ptr);
  71 t_stat do_cmd (int32 flag, char *ptr);
  72 t_stat assert_cmd (int32 flag, char *ptr);
  73 t_stat help_cmd (int32 flag, char *ptr);
  74 t_stat spawn_cmd (int32 flag, char *ptr);
  75 t_stat echo_cmd (int32 flag, char *ptr);
  76
  77 /* Utility routines */
  78
  79 t_stat sim_process_event (void);
  80 t_stat sim_activate (UNIT *uptr, int32 interval);
  81 t_stat sim_activate_abs (UNIT *uptr, int32 interval);
  82 t_stat sim_cancel (UNIT *uptr);
  83 int32 sim_is_active (UNIT *uptr);
  84 double sim_gtime (void);
  85 uint32 sim_grtime (void);
  86 int32 sim_qcount (void);
  87 t_stat attach_unit (UNIT *uptr, char *cptr);
  88 t_stat detach_unit (UNIT *uptr);
  89 t_stat assign_device (DEVICE *dptr, char *cptr);
  90 t_stat deassign_device (DEVICE *dptr);
  91 t_stat reset_all (uint32 start_device);
  92 t_stat reset_all_p (uint32 start_device);
  93 char *sim_dname (DEVICE *dptr);
  94 t_stat get_yn (char *ques, t_stat deflt);
  95 char *get_sim_opt (int32 opt, char *cptr, t_stat *st);
  96 char *get_glyph (char *iptr, char *optr, char mchar);
  97 char *get_glyph_nc (char *iptr, char *optr, char mchar);
  98 t_value get_uint (char *cptr, uint32 radix, t_value max, t_stat *status);
  99 char *get_range (DEVICE *dptr, char *cptr, t_addr *lo, t_addr *hi,
 100     uint32 rdx, t_addr max, char term);
 101 t_stat get_ipaddr (char *cptr, uint32 *ipa, uint32 *ipp);
 102 t_value strtotv (char *cptr, char **endptr, uint32 radix);
 103 t_stat fprint_val (FILE *stream, t_value val, uint32 rdx, uint32 wid, uint32 fmt);
 104 CTAB *find_cmd (char *gbuf);
 105 DEVICE *find_dev (char *ptr);
 106 DEVICE *find_unit (char *ptr, UNIT **uptr);
 107 DEVICE *find_dev_from_unit (UNIT *uptr);
 108 REG *find_reg (char *ptr, char **optr, DEVICE *dptr);
 109 CTAB *find_ctab (CTAB *tab, char *gbuf);
 110 C1TAB *find_c1tab (C1TAB *tab, char *gbuf);
 111 SHTAB *find_shtab (SHTAB *tab, char *gbuf);
 112 BRKTAB *sim_brk_fnd (t_addr loc);
 113 uint32 sim_brk_test (t_addr bloc, uint32 btyp);
 114 void sim_brk_clrspc (uint32 spc);
 115 char *match_ext (char *fnam, char *ext);
 116 t_stat sim_cancel_step (void);
 117 void sim_debug_u16 (uint32 dbits, DEVICE* dptr, const char* const* bitdefs,
 118     uint16 before, uint16 after, int terminate);
 119 void sim_debug (uint32 dbits, DEVICE* dptr, const char* fmt, ...);
 120 void fprint_stopped_gen (FILE *st, t_stat v, REG *pc, DEVICE *dptr);
 121
 122 #endif