ss.h revision e0ed7404719a9ddd2ba427a80db5365c8bad18c0
1656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project/* 2656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * Copyright 1987, 1988 by MIT Student Information Processing Board 3656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * 4656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * Permission to use, copy, modify, and distribute this software and 5656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * its documentation for any purpose is hereby granted, provided that 6656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * the names of M.I.T. and the M.I.T. S.I.P.B. not be used in 7656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * advertising or publicity pertaining to distribution of the software 8656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * without specific, written prior permission. M.I.T. and the 9656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * M.I.T. S.I.P.B. make no representations about the suitability of 10656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * this software for any purpose. It is provided "as is" without 11656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * express or implied warranty. 12656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * 13656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * This quote is just too good to not pass on: 14656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * 15656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * "BTW, I would have rejected the name Story Server because its 16656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * initials are SS, the name of the secret police in Nazi 17656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * Germany, probably the most despised pair of letters in western 18656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * culture." --- http://scriptingnewsarchive.userland.com/1999/12/13 19656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * 20656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project * Let no one say political correctness isn't dead.... 21656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project */ 22656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 23656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#ifndef _ss_h 24656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define _ss_h __FILE__ 25656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 26656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#include <ss/ss_err.h> 27656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 28656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define __SS_CONST const 29656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define __SS_PROTO (int, const char * const *, int, void *) 30656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 31221304ee937bc0910948a8be1320cb8cc4eb6d36Brian Carlstrom#ifdef __GNUC__ 32656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define __SS_ATTR(x) __attribute__(x) 33656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#else 34656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define __SS_ATTR(x) 35656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#endif 36656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 37656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 38656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projecttypedef __SS_CONST struct _ss_request_entry { 39656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project __SS_CONST char * __SS_CONST *command_names; /* whatever */ 40656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project void (* __SS_CONST function) __SS_PROTO; /* foo */ 41656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project __SS_CONST char * __SS_CONST info_string; /* NULL */ 42656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int flags; /* 0 */ 43656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project} ss_request_entry; 44656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 45656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projecttypedef __SS_CONST struct _ss_request_table { 46656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int version; 47656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project ss_request_entry *requests; 48656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project} ss_request_table; 49656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 50656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define SS_RQT_TBL_V2 2 51656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 52656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projecttypedef struct _ss_rp_options { /* DEFAULT VALUES */ 53656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int version; /* SS_RP_V1 */ 54656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project void (*unknown) __SS_PROTO; /* call for unknown command */ 55656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int allow_suspend; 56656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int catch_int; 57656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project} ss_rp_options; 58656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 59656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define SS_RP_V1 1 60656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 61656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define SS_OPT_DONT_LIST 0x0001 62656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#define SS_OPT_DONT_SUMMARIZE 0x0002 63656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 64656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_help __SS_PROTO; 65656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#if 0 66656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectchar *ss_current_request(); /* This is actually a macro */ 67656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#endif 68656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 69656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectchar *ss_name(int sci_idx); 70656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_error (int, long, char const *, ...) 71656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project __SS_ATTR((format(printf, 3, 4))); 7298d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstromvoid ss_perror (int, long, char const *); 7398d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstrom 7498d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstromint ss_create_invocation(const char *, const char *, void *, 7598d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstrom ss_request_table *, int *); 7698d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstromvoid ss_delete_invocation(int); 7798d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstromint ss_listen(int); 7898d58bb80c64b02a33662f0ea80351d4a1535267Brian Carlstromint ss_execute_line(int, char *); 79221304ee937bc0910948a8be1320cb8cc4eb6d36Brian Carlstromvoid ss_add_request_table(int, ss_request_table *, int, int *); 80221304ee937bc0910948a8be1320cb8cc4eb6d36Brian Carlstromvoid ss_delete_request_table(int, ss_request_table *, int *); 81656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_abort_subsystem(int sci_idx, int code); 82656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_quit(int argc, const char * const *argv, int sci_idx, void *infop); 83656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_self_identify(int argc, const char * const *argv, int sci_idx, void *infop); 84221304ee937bc0910948a8be1320cb8cc4eb6d36Brian Carlstromvoid ss_subsystem_name(int argc, const char * const *argv, 85221304ee937bc0910948a8be1320cb8cc4eb6d36Brian Carlstrom int sci_idx, void *infop); 86656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_subsystem_version(int argc, const char * const *argv, 87656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int sci_idx, void *infop); 88656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_unimplemented(int argc, const char * const *argv, 89656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project int sci_idx, void *infop); 90656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_set_prompt(int sci_idx, char *new_prompt); 91656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectchar *ss_get_prompt(int sci_idx); 92656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectvoid ss_get_readline(int sci_idx); 93656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectchar *ss_safe_getenv(const char *arg); 94656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project 95656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Projectextern ss_request_table ss_std_requests; 96656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project#endif /* _ss_h */ 97656d9c7f52f88b3a3daccafa7655dec086c4756eThe Android Open Source Project