[thirdparty/bash.git] / pcomplete.h

/* pcomplete.h - structure definitions and other stuff for programmable
		 completion. */

/* Copyright (C) 1999-2009 Free Software Foundation, Inc.

   This file is part of GNU Bash, the Bourne Again SHell.

   Bash is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   (at your option) any later version.

   Bash is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with Bash.  If not, see <http://www.gnu.org/licenses/>.
*/

#if !defined (_PCOMPLETE_H_)
#  define _PCOMPLETE_H_

#include "stdc.h"
#include "hashlib.h"

typedef struct compspec {
  int refcount;
  unsigned long actions;
  unsigned long options;
  char *globpat;
  char *words;
  char *prefix;
  char *suffix;
  char *funcname;
  char *command;
  char *lcommand;
  char *filterpat;
} COMPSPEC;

/* Values for COMPSPEC actions.  These are things the shell knows how to
   build internally. */
#define CA_ALIAS	(1<<0)
#define CA_ARRAYVAR	(1<<1)
#define CA_BINDING	(1<<2)
#define CA_BUILTIN	(1<<3)
#define CA_COMMAND	(1<<4)
#define CA_DIRECTORY	(1<<5)
#define CA_DISABLED	(1<<6)
#define CA_ENABLED	(1<<7)
#define CA_EXPORT	(1<<8)
#define CA_FILE		(1<<9)
#define CA_FUNCTION	(1<<10)
#define CA_GROUP	(1<<11)
#define CA_HELPTOPIC	(1<<12)
#define CA_HOSTNAME	(1<<13)
#define CA_JOB		(1<<14)
#define CA_KEYWORD	(1<<15)
#define CA_RUNNING	(1<<16)
#define CA_SERVICE	(1<<17)
#define CA_SETOPT	(1<<18)
#define CA_SHOPT	(1<<19)
#define CA_SIGNAL	(1<<20)
#define CA_STOPPED	(1<<21)
#define CA_USER		(1<<22)
#define CA_VARIABLE	(1<<23)

/* Values for COMPSPEC options field. */
#define COPT_RESERVED	(1<<0)		/* reserved for other use */
#define COPT_DEFAULT	(1<<1)
#define COPT_FILENAMES	(1<<2)
#define COPT_DIRNAMES	(1<<3)
#define COPT_NOQUOTE	(1<<4)
#define COPT_NOSPACE	(1<<5)
#define COPT_BASHDEFAULT (1<<6)
#define COPT_PLUSDIRS	(1<<7)
#define COPT_NOSORT	(1<<8)

/* List of items is used by the code that implements the programmable
   completions. */
typedef struct _list_of_items {
  int flags;
  int (*list_getter) __P((struct _list_of_items *));	/* function to call to get the list */

  STRINGLIST *slist;

  /* These may or may not be used. */
  STRINGLIST *genlist;	/* for handing to the completion code one item at a time */
  int genindex;		/* index of item last handed to completion code */

} ITEMLIST;

/* Values for ITEMLIST -> flags */
#define LIST_DYNAMIC		0x001
#define LIST_DIRTY		0x002
#define LIST_INITIALIZED	0x004
#define LIST_MUSTSORT		0x008
#define LIST_DONTFREE		0x010
#define LIST_DONTFREEMEMBERS	0x020

#define EMPTYCMD	"_EmptycmD_"
#define DEFAULTCMD	"_DefaultCmD_"

extern HASH_TABLE *prog_completes;
extern int prog_completion_enabled;

/* Not all of these are used yet. */
extern ITEMLIST it_aliases;
extern ITEMLIST it_arrayvars;
extern ITEMLIST it_bindings;
extern ITEMLIST it_builtins;
extern ITEMLIST it_commands;
extern ITEMLIST it_directories;
extern ITEMLIST it_disabled;
extern ITEMLIST it_enabled;
extern ITEMLIST it_exports;
extern ITEMLIST it_files;
extern ITEMLIST it_functions;
extern ITEMLIST it_groups;
extern ITEMLIST it_helptopics;
extern ITEMLIST it_hostnames;
extern ITEMLIST it_jobs;
extern ITEMLIST it_keywords;
extern ITEMLIST it_running;
extern ITEMLIST it_services;
extern ITEMLIST it_setopts;
extern ITEMLIST it_shopts;
extern ITEMLIST it_signals;
extern ITEMLIST it_stopped;
extern ITEMLIST it_users;
extern ITEMLIST it_variables;

extern COMPSPEC *pcomp_curcs;
extern const char *pcomp_curcmd;

/* Functions from pcomplib.c */
extern COMPSPEC *compspec_create __P((void));
extern void compspec_dispose __P((COMPSPEC *));
extern COMPSPEC *compspec_copy __P((COMPSPEC *));

extern void progcomp_create __P((void));
extern void progcomp_flush __P((void));
extern void progcomp_dispose __P((void));

extern int progcomp_size __P((void));

extern int progcomp_insert __P((char *, COMPSPEC *));
extern int progcomp_remove __P((char *));

extern COMPSPEC *progcomp_search __P((const char *));

extern void progcomp_walk __P((hash_wfunc *));

/* Functions from pcomplete.c */
extern void set_itemlist_dirty __P((ITEMLIST *));

extern STRINGLIST *completions_to_stringlist __P((char **));

extern STRINGLIST *gen_compspec_completions __P((COMPSPEC *, const char *, const char *, int, int, int *));
extern char **programmable_completions __P((const char *, const char *, int, int, int *));

extern void pcomp_set_readline_variables __P((int, int));
extern void pcomp_set_compspec_options __P((COMPSPEC *, int, int));
#endif /* _PCOMPLETE_H_ */
Commit	Line	Data
bb70624e	1	/* pcomplete.h - structure definitions and other stuff for programmable
0001803f	2	completion. */
bb70624e	3
3185942a	4	/* Copyright (C) 1999-2009 Free Software Foundation, Inc.
bb70624e JA	5
	6	This file is part of GNU Bash, the Bourne Again SHell.
	7
3185942a JA	8	Bash is free software: you can redistribute it and/or modify
	9	it under the terms of the GNU General Public License as published by
	10	the Free Software Foundation, either version 3 of the License, or
	11	(at your option) any later version.
bb70624e	12
3185942a JA	13	Bash is distributed in the hope that it will be useful,
	14	but WITHOUT ANY WARRANTY; without even the implied warranty of
	15	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	16	GNU General Public License for more details.
bb70624e	17
3185942a JA	18	You should have received a copy of the GNU General Public License
	19	along with Bash. If not, see <http://www.gnu.org/licenses/>.
	20	*/
bb70624e JA	21
	22	#if !defined (_PCOMPLETE_H_)
	23	# define _PCOMPLETE_H_
	24
	25	#include "stdc.h"
	26	#include "hashlib.h"
	27
	28	typedef struct compspec {
	29	int refcount;
	30	unsigned long actions;
28ef6c31	31	unsigned long options;
bb70624e JA	32	char *globpat;
	33	char *words;
	34	char *prefix;
	35	char *suffix;
	36	char *funcname;
	37	char *command;
495aee44	38	char *lcommand;
bb70624e JA	39	char *filterpat;
	40	} COMPSPEC;
	41
	42	/* Values for COMPSPEC actions. These are things the shell knows how to
	43	build internally. */
	44	#define CA_ALIAS (1<<0)
	45	#define CA_ARRAYVAR (1<<1)
	46	#define CA_BINDING (1<<2)
	47	#define CA_BUILTIN (1<<3)
	48	#define CA_COMMAND (1<<4)
	49	#define CA_DIRECTORY (1<<5)
	50	#define CA_DISABLED (1<<6)
	51	#define CA_ENABLED (1<<7)
	52	#define CA_EXPORT (1<<8)
	53	#define CA_FILE (1<<9)
	54	#define CA_FUNCTION (1<<10)
f73dda09 JA	55	#define CA_GROUP (1<<11)
	56	#define CA_HELPTOPIC (1<<12)
	57	#define CA_HOSTNAME (1<<13)
	58	#define CA_JOB (1<<14)
	59	#define CA_KEYWORD (1<<15)
	60	#define CA_RUNNING (1<<16)
7117c2d2 JA	61	#define CA_SERVICE (1<<17)
	62	#define CA_SETOPT (1<<18)
	63	#define CA_SHOPT (1<<19)
	64	#define CA_SIGNAL (1<<20)
	65	#define CA_STOPPED (1<<21)
	66	#define CA_USER (1<<22)
	67	#define CA_VARIABLE (1<<23)
bb70624e	68
28ef6c31 JA	69	/* Values for COMPSPEC options field. */
	70	#define COPT_RESERVED (1<<0) /* reserved for other use */
	71	#define COPT_DEFAULT (1<<1)
	72	#define COPT_FILENAMES (1<<2)
	73	#define COPT_DIRNAMES (1<<3)
ac50fbac CR	74	#define COPT_NOQUOTE (1<<4)
	75	#define COPT_NOSPACE (1<<5)
	76	#define COPT_BASHDEFAULT (1<<6)
	77	#define COPT_PLUSDIRS (1<<7)
a0c0a00f	78	#define COPT_NOSORT (1<<8)
bb70624e JA	79
	80	/* List of items is used by the code that implements the programmable
	81	completions. */
	82	typedef struct _list_of_items {
	83	int flags;
f73dda09	84	int (list_getter) __P((struct _list_of_items )); /* function to call to get the list */
bb70624e JA	85
	86	STRINGLIST *slist;
	87
	88	/* These may or may not be used. */
	89	STRINGLIST genlist; / for handing to the completion code one item at a time */
	90	int genindex; /* index of item last handed to completion code */
	91
	92	} ITEMLIST;
	93
	94	/* Values for ITEMLIST -> flags */
	95	#define LIST_DYNAMIC 0x001
	96	#define LIST_DIRTY 0x002
	97	#define LIST_INITIALIZED 0x004
	98	#define LIST_MUSTSORT 0x008
	99	#define LIST_DONTFREE 0x010
	100	#define LIST_DONTFREEMEMBERS 0x020
	101
0001803f CR	102	#define EMPTYCMD "_EmptycmD_"
	103	#define DEFAULTCMD "_DefaultCmD_"
	104
bb70624e JA	105	extern HASH_TABLE *prog_completes;
	106	extern int prog_completion_enabled;
	107
	108	/* Not all of these are used yet. */
	109	extern ITEMLIST it_aliases;
	110	extern ITEMLIST it_arrayvars;
	111	extern ITEMLIST it_bindings;
	112	extern ITEMLIST it_builtins;
	113	extern ITEMLIST it_commands;
	114	extern ITEMLIST it_directories;
	115	extern ITEMLIST it_disabled;
	116	extern ITEMLIST it_enabled;
	117	extern ITEMLIST it_exports;
	118	extern ITEMLIST it_files;
	119	extern ITEMLIST it_functions;
f73dda09	120	extern ITEMLIST it_groups;
ac50fbac	121	extern ITEMLIST it_helptopics;
bb70624e JA	122	extern ITEMLIST it_hostnames;
	123	extern ITEMLIST it_jobs;
	124	extern ITEMLIST it_keywords;
	125	extern ITEMLIST it_running;
7117c2d2	126	extern ITEMLIST it_services;
bb70624e JA	127	extern ITEMLIST it_setopts;
	128	extern ITEMLIST it_shopts;
	129	extern ITEMLIST it_signals;
	130	extern ITEMLIST it_stopped;
	131	extern ITEMLIST it_users;
	132	extern ITEMLIST it_variables;
	133
3185942a JA	134	extern COMPSPEC *pcomp_curcs;
	135	extern const char *pcomp_curcmd;
	136
bb70624e	137	/* Functions from pcomplib.c */
7117c2d2 JA	138	extern COMPSPEC *compspec_create __P((void));
	139	extern void compspec_dispose __P((COMPSPEC *));
	140	extern COMPSPEC compspec_copy __P((COMPSPEC ));
bb70624e	141
7117c2d2 JA	142	extern void progcomp_create __P((void));
	143	extern void progcomp_flush __P((void));
	144	extern void progcomp_dispose __P((void));
bb70624e	145
7117c2d2	146	extern int progcomp_size __P((void));
bb70624e	147
7117c2d2 JA	148	extern int progcomp_insert __P((char , COMPSPEC ));
7117c2d2 JA	149	extern int progcomp_remove __P((char *));
bb70624e	150
7117c2d2	151	extern COMPSPEC progcomp_search __P((const char ));
bb70624e	152
7117c2d2	153	extern void progcomp_walk __P((hash_wfunc *));
bb70624e JA	154
	155	/* Functions from pcomplete.c */
	156	extern void set_itemlist_dirty __P((ITEMLIST *));
	157
f73dda09 JA	158	extern STRINGLIST completions_to_stringlist __P((char *));
f73dda09 JA	159
0001803f	160	extern STRINGLIST gen_compspec_completions __P((COMPSPEC , const char , const char , int, int, int *));
28ef6c31	161	extern char *programmable_completions __P((const char , const char , int, int, int ));
bb70624e	162
3185942a JA	163	extern void pcomp_set_readline_variables __P((int, int));
3185942a JA	164	extern void pcomp_set_compspec_options __P((COMPSPEC *, int, int));
bb70624e	165	#endif /* _PCOMPLETE_H_ */