[thirdparty/bash.git] / pcomplete.h

/* pcomplete.h - structure definitions and other stuff for programmable
n		 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 *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

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));
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
3185942a	2	n 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;
	38	char *filterpat;
	39	} COMPSPEC;
	40
	41	/* Values for COMPSPEC actions. These are things the shell knows how to
	42	build internally. */
	43	#define CA_ALIAS (1<<0)
	44	#define CA_ARRAYVAR (1<<1)
	45	#define CA_BINDING (1<<2)
	46	#define CA_BUILTIN (1<<3)
	47	#define CA_COMMAND (1<<4)
	48	#define CA_DIRECTORY (1<<5)
	49	#define CA_DISABLED (1<<6)
	50	#define CA_ENABLED (1<<7)
	51	#define CA_EXPORT (1<<8)
	52	#define CA_FILE (1<<9)
	53	#define CA_FUNCTION (1<<10)
f73dda09 JA	54	#define CA_GROUP (1<<11)
	55	#define CA_HELPTOPIC (1<<12)
	56	#define CA_HOSTNAME (1<<13)
	57	#define CA_JOB (1<<14)
	58	#define CA_KEYWORD (1<<15)
	59	#define CA_RUNNING (1<<16)
7117c2d2 JA	60	#define CA_SERVICE (1<<17)
	61	#define CA_SETOPT (1<<18)
	62	#define CA_SHOPT (1<<19)
	63	#define CA_SIGNAL (1<<20)
	64	#define CA_STOPPED (1<<21)
	65	#define CA_USER (1<<22)
	66	#define CA_VARIABLE (1<<23)
bb70624e	67
28ef6c31 JA	68	/* Values for COMPSPEC options field. */
	69	#define COPT_RESERVED (1<<0) /* reserved for other use */
	70	#define COPT_DEFAULT (1<<1)
	71	#define COPT_FILENAMES (1<<2)
	72	#define COPT_DIRNAMES (1<<3)
7117c2d2	73	#define COPT_NOSPACE (1<<4)
b80f6443 JA	74	#define COPT_BASHDEFAULT (1<<5)
b80f6443 JA	75	#define COPT_PLUSDIRS (1<<6)
bb70624e JA	76
	77	/* List of items is used by the code that implements the programmable
	78	completions. */
	79	typedef struct _list_of_items {
	80	int flags;
f73dda09	81	int (list_getter) __P((struct _list_of_items )); /* function to call to get the list */
bb70624e JA	82
	83	STRINGLIST *slist;
	84
	85	/* These may or may not be used. */
	86	STRINGLIST genlist; / for handing to the completion code one item at a time */
	87	int genindex; /* index of item last handed to completion code */
	88
	89	} ITEMLIST;
	90
	91	/* Values for ITEMLIST -> flags */
	92	#define LIST_DYNAMIC 0x001
	93	#define LIST_DIRTY 0x002
	94	#define LIST_INITIALIZED 0x004
	95	#define LIST_MUSTSORT 0x008
	96	#define LIST_DONTFREE 0x010
	97	#define LIST_DONTFREEMEMBERS 0x020
	98
	99	extern HASH_TABLE *prog_completes;
	100	extern int prog_completion_enabled;
	101
	102	/* Not all of these are used yet. */
	103	extern ITEMLIST it_aliases;
	104	extern ITEMLIST it_arrayvars;
	105	extern ITEMLIST it_bindings;
	106	extern ITEMLIST it_builtins;
	107	extern ITEMLIST it_commands;
	108	extern ITEMLIST it_directories;
	109	extern ITEMLIST it_disabled;
	110	extern ITEMLIST it_enabled;
	111	extern ITEMLIST it_exports;
	112	extern ITEMLIST it_files;
	113	extern ITEMLIST it_functions;
f73dda09	114	extern ITEMLIST it_groups;
bb70624e JA	115	extern ITEMLIST it_hostnames;
	116	extern ITEMLIST it_jobs;
	117	extern ITEMLIST it_keywords;
	118	extern ITEMLIST it_running;
7117c2d2	119	extern ITEMLIST it_services;
bb70624e JA	120	extern ITEMLIST it_setopts;
	121	extern ITEMLIST it_shopts;
	122	extern ITEMLIST it_signals;
	123	extern ITEMLIST it_stopped;
	124	extern ITEMLIST it_users;
	125	extern ITEMLIST it_variables;
	126
3185942a JA	127	extern COMPSPEC *pcomp_curcs;
	128	extern const char *pcomp_curcmd;
	129
bb70624e	130	/* Functions from pcomplib.c */
7117c2d2 JA	131	extern COMPSPEC *compspec_create __P((void));
	132	extern void compspec_dispose __P((COMPSPEC *));
	133	extern COMPSPEC compspec_copy __P((COMPSPEC ));
bb70624e	134
7117c2d2 JA	135	extern void progcomp_create __P((void));
	136	extern void progcomp_flush __P((void));
	137	extern void progcomp_dispose __P((void));
bb70624e	138
7117c2d2	139	extern int progcomp_size __P((void));
bb70624e	140
7117c2d2 JA	141	extern int progcomp_insert __P((char , COMPSPEC ));
7117c2d2 JA	142	extern int progcomp_remove __P((char *));
bb70624e	143
7117c2d2	144	extern COMPSPEC progcomp_search __P((const char ));
bb70624e	145
7117c2d2	146	extern void progcomp_walk __P((hash_wfunc *));
bb70624e JA	147
	148	/* Functions from pcomplete.c */
	149	extern void set_itemlist_dirty __P((ITEMLIST *));
	150
f73dda09 JA	151	extern STRINGLIST completions_to_stringlist __P((char *));
f73dda09 JA	152
28ef6c31 JA	153	extern STRINGLIST gen_compspec_completions __P((COMPSPEC , const char , const char , int, int));
28ef6c31 JA	154	extern char *programmable_completions __P((const char , const char , int, int, int ));
bb70624e	155
3185942a JA	156	extern void pcomp_set_readline_variables __P((int, int));
3185942a JA	157	extern void pcomp_set_compspec_options __P((COMPSPEC *, int, int));
bb70624e	158	#endif /* _PCOMPLETE_H_ */