1 /* util.c -- readline utility functions */
3 /* Copyright (C) 1987-2017 Free Software Foundation, Inc.
5 This file is part of the GNU Readline Library (Readline), a library
6 for reading lines of text with interactive input and history editing.
8 Readline 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.
13 Readline 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.
18 You should have received a copy of the GNU General Public License
19 along with Readline. If not, see <http://www.gnu.org/licenses/>.
22 #define READLINE_LIBRARY
24 #if defined (HAVE_CONFIG_H)
28 #include <sys/types.h>
32 #if defined (HAVE_UNISTD_H)
33 # include <unistd.h> /* for _POSIX_VERSION */
34 #endif /* HAVE_UNISTD_H */
36 #if defined (HAVE_STDLIB_H)
39 # include "ansi_stdlib.h"
40 #endif /* HAVE_STDLIB_H */
45 /* System-specific feature definitions and include files. */
49 #if defined (TIOCSTAT_IN_SYS_IOCTL)
50 # include <sys/ioctl.h>
51 #endif /* TIOCSTAT_IN_SYS_IOCTL */
53 /* Some standard library routines. */
56 #include "rlprivate.h"
60 /* **************************************************************** */
62 /* Utility Functions */
64 /* **************************************************************** */
66 /* Return 0 if C is not a member of the class of characters that belong
67 in words, or 1 if it is. */
69 int _rl_allow_pathname_alphabetic_chars
= 0;
70 static const char * const pathname_alphabetic_chars
= "/-_=~.#$";
78 return (_rl_allow_pathname_alphabetic_chars
&&
79 strchr (pathname_alphabetic_chars
, c
) != NULL
);
82 #if defined (HANDLE_MULTIBYTE)
84 _rl_walphabetic (wchar_t wc
)
92 return (_rl_allow_pathname_alphabetic_chars
&&
93 strchr (pathname_alphabetic_chars
, c
) != NULL
);
97 /* How to abort things. */
99 _rl_abort_internal (void)
103 _rl_reset_argument ();
104 rl_clear_pending_input ();
105 rl_deactivate_mark ();
107 while (rl_executing_macro
)
108 _rl_pop_executing_macro ();
109 _rl_kill_kbd_macro ();
111 RL_UNSETSTATE (RL_STATE_MULTIKEY
); /* XXX */
113 rl_last_func
= (rl_command_func_t
*)NULL
;
115 _rl_longjmp (_rl_top_level
, 1);
120 rl_abort (int count
, int key
)
122 return (_rl_abort_internal ());
126 _rl_null_function (int count
, int key
)
132 rl_tty_status (int count
, int key
)
134 #if defined (TIOCSTAT)
135 ioctl (1, TIOCSTAT
, (char *)0);
136 rl_refresh_line (count
, key
);
143 /* Return a copy of the string between FROM and TO.
144 FROM is inclusive, TO is not. */
146 rl_copy_text (int from
, int to
)
151 /* Fix it if the caller is confused. */
156 copy
= (char *)xmalloc (1 + length
);
157 strncpy (copy
, rl_line_buffer
+ from
, length
);
162 /* Increase the size of RL_LINE_BUFFER until it has enough space to hold
165 rl_extend_line_buffer (int len
)
167 while (len
>= rl_line_buffer_len
)
169 rl_line_buffer_len
+= DEFAULT_BUFFER_SIZE
;
170 rl_line_buffer
= (char *)xrealloc (rl_line_buffer
, rl_line_buffer_len
);
177 /* A function for simple tilde expansion. */
179 rl_tilde_expand (int ignore
, int key
)
181 register int start
, end
;
182 char *homedir
, *temp
;
188 if (rl_point
== rl_end
&& rl_line_buffer
[rl_point
] == '~')
190 homedir
= tilde_expand ("~");
191 _rl_replace_text (homedir
, start
, end
);
195 else if (start
>= 0 && rl_line_buffer
[start
] != '~')
197 for (; start
>= 0 && !whitespace (rl_line_buffer
[start
]); start
--)
207 while (whitespace (rl_line_buffer
[end
]) == 0 && end
< rl_end
);
209 if (whitespace (rl_line_buffer
[end
]) || end
>= rl_end
)
212 /* If the first character of the current word is a tilde, perform
213 tilde expansion and insert the result. If not a tilde, do
215 if (rl_line_buffer
[start
] == '~')
217 len
= end
- start
+ 1;
218 temp
= (char *)xmalloc (len
+ 1);
219 strncpy (temp
, rl_line_buffer
+ start
, len
);
221 homedir
= tilde_expand (temp
);
224 _rl_replace_text (homedir
, start
, end
);
231 #if defined (USE_VARARGS)
233 #if defined (PREFER_STDARG)
234 _rl_ttymsg (const char *format
, ...)
236 _rl_ttymsg (va_alist
)
241 #if defined (PREFER_VARARGS)
245 #if defined (PREFER_STDARG)
246 va_start (args
, format
);
249 format
= va_arg (args
, char *);
252 fprintf (stderr
, "readline: ");
253 vfprintf (stderr
, format
, args
);
254 fprintf (stderr
, "\n");
259 rl_forced_update_display ();
263 #if defined (PREFER_STDARG)
264 _rl_errmsg (const char *format
, ...)
266 _rl_errmsg (va_alist
)
271 #if defined (PREFER_VARARGS)
275 #if defined (PREFER_STDARG)
276 va_start (args
, format
);
279 format
= va_arg (args
, char *);
282 fprintf (stderr
, "readline: ");
283 vfprintf (stderr
, format
, args
);
284 fprintf (stderr
, "\n");
290 #else /* !USE_VARARGS */
292 _rl_ttymsg (format
, arg1
, arg2
)
295 fprintf (stderr
, "readline: ");
296 fprintf (stderr
, format
, arg1
, arg2
);
297 fprintf (stderr
, "\n");
299 rl_forced_update_display ();
303 _rl_errmsg (format
, arg1
, arg2
)
306 fprintf (stderr
, "readline: ");
307 fprintf (stderr
, format
, arg1
, arg2
);
308 fprintf (stderr
, "\n");
310 #endif /* !USE_VARARGS */
312 /* **************************************************************** */
314 /* String Utility Functions */
316 /* **************************************************************** */
318 /* Determine if s2 occurs in s1. If so, return a pointer to the
319 match in s1. The compare is case insensitive. */
321 _rl_strindex (const char *s1
, const char *s2
)
323 register int i
, l
, len
;
325 for (i
= 0, l
= strlen (s2
), len
= strlen (s1
); (len
- i
) >= l
; i
++)
326 if (_rl_strnicmp (s1
+ i
, s2
, l
) == 0)
327 return ((char *) (s1
+ i
));
328 return ((char *)NULL
);
332 /* Find the first occurrence in STRING1 of any character from STRING2.
333 Return a pointer to the character in STRING1. */
335 _rl_strpbrk (const char *string1
, const char *string2
)
337 register const char *scan
;
338 #if defined (HANDLE_MULTIBYTE)
342 memset (&ps
, 0, sizeof (mbstate_t));
345 for (; *string1
; string1
++)
347 for (scan
= string2
; *scan
; scan
++)
349 if (*string1
== *scan
)
350 return ((char *)string1
);
352 #if defined (HANDLE_MULTIBYTE)
353 if (MB_CUR_MAX
> 1 && rl_byte_oriented
== 0)
355 v
= _rl_get_char_len (string1
, &ps
);
357 string1
+= v
- 1; /* -1 to account for auto-increment in loop */
361 return ((char *)NULL
);
365 #if !defined (HAVE_STRCASECMP)
366 /* Compare at most COUNT characters from string1 to string2. Case
367 doesn't matter (strncasecmp). */
369 _rl_strnicmp (const char *string1
, const char *string2
, int count
)
371 register const char *s1
;
372 register const char *s2
;
375 if (count
<= 0 || (string1
== string2
))
382 d
= _rl_to_lower (*s1
) - _rl_to_lower (*s2
); /* XXX - cast to unsigned char? */
389 while (--count
!= 0);
394 /* strcmp (), but caseless (strcasecmp). */
396 _rl_stricmp (const char *string1
, const char *string2
)
398 register const char *s1
;
399 register const char *s2
;
408 while ((d
= _rl_to_lower (*s1
) - _rl_to_lower (*s2
)) == 0)
417 #endif /* !HAVE_STRCASECMP */
419 /* Stupid comparison routine for qsort () ing strings. */
421 _rl_qsort_string_compare (char **s1
, char **s2
)
423 #if defined (HAVE_STRCOLL)
424 return (strcoll (*s1
, *s2
));
428 result
= **s1
- **s2
;
430 result
= strcmp (*s1
, *s2
);
436 /* Function equivalents for the macros defined in chardefs.h. */
437 #define FUNCTION_FOR_MACRO(f) int (f) (int c) { return f (c); }
439 FUNCTION_FOR_MACRO (_rl_digit_p
)
440 FUNCTION_FOR_MACRO (_rl_digit_value
)
441 FUNCTION_FOR_MACRO (_rl_lowercase_p
)
442 FUNCTION_FOR_MACRO (_rl_pure_alphabetic
)
443 FUNCTION_FOR_MACRO (_rl_to_lower
)
444 FUNCTION_FOR_MACRO (_rl_to_upper
)
445 FUNCTION_FOR_MACRO (_rl_uppercase_p
)
447 /* A convenience function, to force memory deallocation to be performed
448 by readline. DLLs on Windows apparently require this. */
456 /* Backwards compatibility, now that savestring has been removed from
457 all `public' readline header files. */
458 #undef _rl_savestring
460 _rl_savestring (const char *s
)
462 return (strcpy ((char *)xmalloc (1 + (int)strlen (s
)), (s
)));
466 #if defined (USE_VARARGS)
467 static FILE *_rl_tracefp
;
470 #if defined (PREFER_STDARG)
471 _rl_trace (const char *format
, ...)
478 #if defined (PREFER_VARARGS)
482 #if defined (PREFER_STDARG)
483 va_start (args
, format
);
486 format
= va_arg (args
, char *);
489 if (_rl_tracefp
== 0)
491 vfprintf (_rl_tracefp
, format
, args
);
492 fprintf (_rl_tracefp
, "\n");
493 fflush (_rl_tracefp
);
504 fclose (_rl_tracefp
);
505 #if defined (_WIN32) && !defined (__CYGWIN__)
506 x
= sh_get_env_value ("TEMP");
512 snprintf (fnbuf
, sizeof (fnbuf
), "%s/rltrace.%ld", x
, (long)getpid());
514 _rl_tracefp
= fopen (fnbuf
, "w+");
515 return _rl_tracefp
!= 0;
523 r
= fclose (_rl_tracefp
);
529 _rl_settracefp (FILE *fp
)
537 #if HAVE_DECL_AUDIT_USER_TTY && defined (HAVE_LIBAUDIT_H) && defined (ENABLE_TTY_AUDIT_SUPPORT)
538 #include <sys/socket.h>
539 #include <libaudit.h>
540 #include <linux/audit.h>
541 #include <linux/netlink.h>
543 /* Report STRING to the audit system. */
545 _rl_audit_tty (char *string
)
547 struct audit_message req
;
548 struct sockaddr_nl addr
;
552 fd
= socket (PF_NETLINK
, SOCK_RAW
, NETLINK_AUDIT
);
555 size
= strlen (string
) + 1;
557 if (NLMSG_SPACE (size
) > MAX_AUDIT_MESSAGE_LENGTH
)
560 memset (&req
, 0, sizeof(req
));
561 req
.nlh
.nlmsg_len
= NLMSG_SPACE (size
);
562 req
.nlh
.nlmsg_type
= AUDIT_USER_TTY
;
563 req
.nlh
.nlmsg_flags
= NLM_F_REQUEST
;
564 req
.nlh
.nlmsg_seq
= 0;
566 memcpy (NLMSG_DATA(&req
.nlh
), string
, size
);
567 memset (&addr
, 0, sizeof(addr
));
569 addr
.nl_family
= AF_NETLINK
;
573 sendto (fd
, &req
, req
.nlh
.nlmsg_len
, 0, (struct sockaddr
*)&addr
, sizeof(addr
));