[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_NOSPACE	(1<<4)
#define COPT_BASHDEFAULT (1<<5)
#define COPT_PLUSDIRS	(1<<6)

/* 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_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)
7117c2d2	74	#define COPT_NOSPACE (1<<4)
b80f6443 JA	75	#define COPT_BASHDEFAULT (1<<5)
b80f6443 JA	76	#define COPT_PLUSDIRS (1<<6)
bb70624e JA	77
	78	/* List of items is used by the code that implements the programmable
	79	completions. */
	80	typedef struct _list_of_items {
	81	int flags;
f73dda09	82	int (list_getter) __P((struct _list_of_items )); /* function to call to get the list */
bb70624e JA	83
	84	STRINGLIST *slist;
	85
	86	/* These may or may not be used. */
	87	STRINGLIST genlist; / for handing to the completion code one item at a time */
	88	int genindex; /* index of item last handed to completion code */
	89
	90	} ITEMLIST;
	91
	92	/* Values for ITEMLIST -> flags */
	93	#define LIST_DYNAMIC 0x001
	94	#define LIST_DIRTY 0x002
	95	#define LIST_INITIALIZED 0x004
	96	#define LIST_MUSTSORT 0x008
	97	#define LIST_DONTFREE 0x010
	98	#define LIST_DONTFREEMEMBERS 0x020
	99
0001803f CR	100	#define EMPTYCMD "_EmptycmD_"
	101	#define DEFAULTCMD "_DefaultCmD_"
	102
bb70624e JA	103	extern HASH_TABLE *prog_completes;
	104	extern int prog_completion_enabled;
	105
	106	/* Not all of these are used yet. */
	107	extern ITEMLIST it_aliases;
	108	extern ITEMLIST it_arrayvars;
	109	extern ITEMLIST it_bindings;
	110	extern ITEMLIST it_builtins;
	111	extern ITEMLIST it_commands;
	112	extern ITEMLIST it_directories;
	113	extern ITEMLIST it_disabled;
	114	extern ITEMLIST it_enabled;
	115	extern ITEMLIST it_exports;
	116	extern ITEMLIST it_files;
	117	extern ITEMLIST it_functions;
f73dda09	118	extern ITEMLIST it_groups;
bb70624e JA	119	extern ITEMLIST it_hostnames;
	120	extern ITEMLIST it_jobs;
	121	extern ITEMLIST it_keywords;
	122	extern ITEMLIST it_running;
7117c2d2	123	extern ITEMLIST it_services;
bb70624e JA	124	extern ITEMLIST it_setopts;
	125	extern ITEMLIST it_shopts;
	126	extern ITEMLIST it_signals;
	127	extern ITEMLIST it_stopped;
	128	extern ITEMLIST it_users;
	129	extern ITEMLIST it_variables;
	130
3185942a JA	131	extern COMPSPEC *pcomp_curcs;
	132	extern const char *pcomp_curcmd;
	133
bb70624e	134	/* Functions from pcomplib.c */
7117c2d2 JA	135	extern COMPSPEC *compspec_create __P((void));
	136	extern void compspec_dispose __P((COMPSPEC *));
	137	extern COMPSPEC compspec_copy __P((COMPSPEC ));
bb70624e	138
7117c2d2 JA	139	extern void progcomp_create __P((void));
	140	extern void progcomp_flush __P((void));
	141	extern void progcomp_dispose __P((void));
bb70624e	142
7117c2d2	143	extern int progcomp_size __P((void));
bb70624e	144
7117c2d2 JA	145	extern int progcomp_insert __P((char , COMPSPEC ));
7117c2d2 JA	146	extern int progcomp_remove __P((char *));
bb70624e	147
7117c2d2	148	extern COMPSPEC progcomp_search __P((const char ));
bb70624e	149
7117c2d2	150	extern void progcomp_walk __P((hash_wfunc *));
bb70624e JA	151
	152	/* Functions from pcomplete.c */
	153	extern void set_itemlist_dirty __P((ITEMLIST *));
	154
f73dda09 JA	155	extern STRINGLIST completions_to_stringlist __P((char *));
f73dda09 JA	156
0001803f	157	extern STRINGLIST gen_compspec_completions __P((COMPSPEC , const char , const char , int, int, int *));
28ef6c31	158	extern char *programmable_completions __P((const char , const char , int, int, int ));
bb70624e	159
3185942a JA	160	extern void pcomp_set_readline_variables __P((int, int));
3185942a JA	161	extern void pcomp_set_compspec_options __P((COMPSPEC *, int, int));
bb70624e	162	#endif /* _PCOMPLETE_H_ */