Home | History | Annotate | Line # | Download | only in ex
      1 /*	$NetBSD: ex.h,v 1.3 2013/11/25 22:43:46 christos Exp $ */
      2 /*-
      3  * Copyright (c) 1992, 1993, 1994
      4  *	The Regents of the University of California.  All rights reserved.
      5  * Copyright (c) 1992, 1993, 1994, 1995, 1996
      6  *	Keith Bostic.  All rights reserved.
      7  *
      8  * See the LICENSE file for redistribution information.
      9  *
     10  *	Id: ex.h,v 10.30 2004/03/16 14:11:33 skimo Exp  (Berkeley) Date: 2004/03/16 14:11:33
     11  */
     12 
     13 #define	PROMPTCHAR	':'		/* Prompt using a colon. */
     14 
     15 typedef struct _excmdlist {		/* Ex command table structure. */
     16 	const CHAR_T *name;		/* Command name, underlying function. */
     17 	int (*fn) __P((SCR *, EXCMD *));
     18 
     19 #define	E_ADDR1		0x00000001	/* One address. */
     20 #define	E_ADDR2		0x00000002	/* Two addresses. */
     21 #define	E_ADDR2_ALL	0x00000004	/* Zero/two addresses; zero == all. */
     22 #define	E_ADDR2_NONE	0x00000008	/* Zero/two addresses; zero == none. */
     23 #define	E_ADDR_ZERO	0x00000010	/* 0 is a legal addr1. */
     24 #define	E_ADDR_ZERODEF	0x00000020	/* 0 is default addr1 of empty files. */
     25 #define	E_AUTOPRINT	0x00000040	/* Command always sets autoprint. */
     26 #define	E_CLRFLAG	0x00000080	/* Clear the print (#, l, p) flags. */
     27 #define	E_NEWSCREEN	0x00000100	/* Create a new screen. */
     28 #define	E_SECURE	0x00000200	/* Permission denied if O_SECURE set. */
     29 #define	E_VIONLY	0x00000400	/* Meaningful only in vi. */
     30 #define	__INUSE1	0xfffff800	/* Same name space as EX_PRIVATE. */
     31 	u_int16_t flags;
     32 
     33 	const char *syntax;		/* Syntax script. */
     34 	const char *usage;		/* Usage line. */
     35 	const char *help;		/* Help line. */
     36 } EXCMDLIST;
     37 
     38 #define	MAXCMDNAMELEN	12		/* Longest command name. */
     39 extern EXCMDLIST const cmds[];		/* Table of ex commands. */
     40 
     41 /*
     42  * !!!
     43  * QUOTING NOTE:
     44  *
     45  * Historically, .exrc files and EXINIT variables could only use ^V as an
     46  * escape character, neither ^Q or a user specified character worked.  We
     47  * enforce that here, just in case someone depends on it.
     48  */
     49 #define	IS_ESCAPE(sp, cmdp, ch)						\
     50 	(F_ISSET(cmdp, E_VLITONLY) ?					\
     51 	    (ch) == CH_LITERAL : KEY_VAL(sp, ch) == K_VLNEXT)
     52 
     53 /*
     54  * File state must be checked for each command -- any ex command may be entered
     55  * at any time, and most of them won't work well if a file hasn't yet been read
     56  * in.  Historic vi generally took the easy way out and dropped core.
     57  */
     58 #define	NEEDFILE(sp, cmdp) {						\
     59 	if ((sp)->ep == NULL) {						\
     60 		ex_wemsg(sp, (cmdp)->cmd->name, EXM_NOFILEYET);		\
     61 		return (1);						\
     62 	}								\
     63 }
     64 
     65 /* Range structures for global and @ commands. */
     66 typedef struct _range RANGE;
     67 struct _range {				/* Global command range. */
     68 	TAILQ_ENTRY(_range) q;	/* Linked list of ranges. */
     69 	db_recno_t start, stop;		/* Start/stop of the range. */
     70 };
     71 
     72 /* Ex command structure. */
     73 struct _excmd {
     74 	LIST_ENTRY(_excmd) q;		/* Linked list of commands. */
     75 
     76 	char	 *if_name;		/* Associated file. */
     77 	db_recno_t	  if_lno;		/* Associated line number. */
     78 
     79 	/* Clear the structure for the ex parser. */
     80 #define	CLEAR_EX_PARSER(cmdp)						\
     81 	memset(&((cmdp)->cp), 0, ((char *)&(cmdp)->flags -		\
     82 	    (char *)&((cmdp)->cp)) + sizeof((cmdp)->flags))
     83 
     84 	CHAR_T	 *cp;			/* Current command text. */
     85 	size_t	  clen;			/* Current command length. */
     86 
     87 	CHAR_T	 *save_cmd;		/* Remaining command. */
     88 	size_t	  save_cmdlen;		/* Remaining command length. */
     89 
     90 	EXCMDLIST const *cmd;		/* Command: entry in command table. */
     91 	EXCMDLIST rcmd;			/* Command: table entry/replacement. */
     92 
     93 	TAILQ_HEAD(_rh, _range) rq;	/* @/global range: linked list. */
     94 	db_recno_t   range_lno;		/* @/global range: set line number. */
     95 	CHAR_T	 *o_cp;			/* Original @/global command. */
     96 	size_t	  o_clen;		/* Original @/global command length. */
     97 #define	AGV_AT		0x01		/* @ buffer execution. */
     98 #define	AGV_AT_NORANGE	0x02		/* @ buffer execution without range. */
     99 #define	AGV_GLOBAL	0x04		/* global command. */
    100 #define	AGV_V		0x08		/* v command. */
    101 #define	AGV_ALL		(AGV_AT | AGV_AT_NORANGE | AGV_GLOBAL | AGV_V)
    102 	u_int8_t  agv_flags;
    103 
    104 	/* Clear the structure before each ex command. */
    105 #define	CLEAR_EX_CMD(cmdp) {						\
    106 	u_int32_t L__f = F_ISSET(cmdp, E_PRESERVE);			\
    107 	memset(&((cmdp)->buffer), 0, ((char *)&(cmdp)->flags -		\
    108 	    (char *)&((cmdp)->buffer)) + sizeof((cmdp)->flags));	\
    109 	F_SET(cmdp, L__f);						\
    110 }
    111 
    112 	ARG_CHAR_T	  buffer;		/* Command: named buffer. */
    113 	db_recno_t	  lineno;		/* Command: line number. */
    114 	long	  count;		/* Command: signed count. */
    115 	long	  flagoff;		/* Command: signed flag offset. */
    116 	int	  addrcnt;		/* Command: addresses (0, 1 or 2). */
    117 	MARK	  addr1;		/* Command: 1st address. */
    118 	MARK	  addr2;		/* Command: 2nd address. */
    119 	ARGS	**argv;			/* Command: array of arguments. */
    120 	int	  argc;			/* Command: count of arguments. */
    121 
    122 #define	E_C_BUFFER	0x00001		/* Buffer name specified. */
    123 #define	E_C_CARAT	0x00002		/*  ^ flag. */
    124 #define	E_C_COUNT	0x00004		/* Count specified. */
    125 #define	E_C_COUNT_NEG	0x00008		/* Count was signed negative. */
    126 #define	E_C_COUNT_POS	0x00010		/* Count was signed positive. */
    127 #define	E_C_DASH	0x00020		/*  - flag. */
    128 #define	E_C_DOT		0x00040		/*  . flag. */
    129 #define	E_C_EQUAL	0x00080		/*  = flag. */
    130 #define	E_C_FORCE	0x00100		/*  ! flag. */
    131 #define	E_C_HASH	0x00200		/*  # flag. */
    132 #define	E_C_LIST	0x00400		/*  l flag. */
    133 #define	E_C_PLUS	0x00800		/*  + flag. */
    134 #define	E_C_PRINT	0x01000		/*  p flag. */
    135 	u_int16_t iflags;		/* User input information. */
    136 
    137 #define	__INUSE2	0x000007ff	/* Same name space as EXCMDLIST. */
    138 #define	E_BLIGNORE	0x00000800	/* Ignore blank lines. */
    139 #define	E_NAMEDISCARD	0x00001000	/* Free/discard the name. */
    140 #define	E_NOAUTO	0x00002000	/* Don't do autoprint output. */
    141 #define	E_NOPRDEF	0x00004000	/* Don't print as default. */
    142 #define	E_NRSEP		0x00008000	/* Need to line adjust ex output. */
    143 #define	E_OPTNUM	0x00010000	/* Number edit option affected. */
    144 #define	E_VLITONLY	0x00020000	/* Use ^V quoting only. */
    145 #define	E_PRESERVE	0x0003f800	/* Bits to preserve across commands. */
    146 
    147 #define	E_ABSMARK	0x00040000	/* Set the absolute mark. */
    148 #define	E_ADDR_DEF	0x00080000	/* Default addresses used. */
    149 #define	E_DELTA		0x00100000	/* Search address with delta. */
    150 #define	E_MODIFY	0x00200000	/* File name expansion modified arg. */
    151 #define	E_MOVETOEND	0x00400000	/* Move to the end of the file first. */
    152 #define	E_NEWLINE	0x00800000	/* Found ending <newline>. */
    153 #define	E_SEARCH_WMSG	0x01000000	/* Display search-wrapped message. */
    154 #define	E_USELASTCMD	0x02000000	/* Use the last command. */
    155 #define	E_VISEARCH	0x04000000	/* It's really a vi search command. */
    156 #ifdef GTAGS
    157 #define	E_REFERENCE	0x08000000	/* locate function references */
    158 #endif
    159 	u_int32_t flags;		/* Current flags. */
    160 };
    161 
    162 /* Ex private, per-screen memory. */
    163 typedef struct _ex_private {
    164 	TAILQ_HEAD(_tqh, _tagq) tq;	/* Tag queue. */
    165 	TAILQ_HEAD(_tagfh, _tagf) tagfq;/* Tag file list. */
    166 	LIST_HEAD(_csch, _csc) cscq;    /* Cscope connection list. */
    167 	CHAR_T	*tag_last;		/* Saved last tag string. */
    168 
    169 	CHAR_T	*lastbcomm;		/* Last bang command. */
    170 
    171 	ARGS   **args;			/* Command: argument list. */
    172 	int	 argscnt;		/* Command: argument list count. */
    173 	int	 argsoff;		/* Command: offset into arguments. */
    174 
    175 	u_int32_t fdef;			/* Saved E_C_* default command flags. */
    176 
    177 	char	*ibp;			/* File line input buffer. */
    178 	size_t	 ibp_len;		/* File line input buffer length. */
    179 	CONVWIN	 ibcw;			/* File line input conversion buffer. */
    180 
    181 	/*
    182 	 * Buffers for the ex output.  The screen/vi support doesn't do any
    183 	 * character buffering of any kind.  We do it here so that we're not
    184 	 * calling the screen output routines on every character.
    185 	 *
    186 	 * XXX
    187 	 * Change to grow dynamically.
    188 	 */
    189 	char	 obp[1024];		/* Ex output buffer. */
    190 	size_t	 obp_len;		/* Ex output buffer length. */
    191 
    192 #define	EXP_CSCINIT	0x01		/* Cscope initialized. */
    193 	u_int8_t flags;
    194 } EX_PRIVATE;
    195 #define	EXP(sp)	((EX_PRIVATE *)((sp)->ex_private))
    196 
    197 /*
    198  * Filter actions:
    199  *
    200  *	FILTER_BANG	!:	filter text through the utility.
    201  *	FILTER_RBANG	!:	read from the utility (without stdin).
    202  *	FILTER_READ	read:	read from the utility (with stdin).
    203  *	FILTER_WRITE	write:	write to the utility, display its output.
    204  */
    205 enum filtertype { FILTER_BANG, FILTER_RBANG, FILTER_READ, FILTER_WRITE };
    206 
    207 /* Ex common error messages. */
    208 typedef enum {
    209 	EXM_EMPTYBUF,			/* Empty buffer. */
    210 	EXM_FILECOUNT,			/* Too many file names. */
    211 	EXM_LOCKED,			/* Another thread is active. */
    212 	EXM_NOCANON,			/* No terminal interface. */
    213 	EXM_NOCANON_F,			/* EXM_NOCANO: filter version. */
    214 	EXM_NOFILEYET,			/* Illegal until a file read in. */
    215 	EXM_NOPREVBUF,			/* No previous buffer specified. */
    216 	EXM_NOPREVRE,			/* No previous RE specified. */
    217 	EXM_NOSUSPEND,			/* No suspension. */
    218 	EXM_SECURE,			/* Illegal if secure edit option set. */
    219 	EXM_SECURE_F,			/* EXM_SECURE: filter version */
    220 	EXM_USAGE			/* Standard usage message. */
    221 } exm_t;
    222 
    223 /* Ex address error types. */
    224 enum badaddr { A_COMBO, A_EMPTY, A_EOF, A_NOTSET, A_ZERO };
    225 
    226 /* Ex common tag error messages. */
    227 typedef enum {
    228 	TAG_BADLNO,		/* Tag line doesn't exist. */
    229 	TAG_EMPTY,		/* Tags stack is empty. */
    230 	TAG_SEARCH		/* Tags search pattern wasn't found. */
    231 } tagmsg_t;
    232 
    233 #include "ex_def.h"
    234 #include "ex_extern.h"
    235