1 /* Core dump and executable file functions below target vector, for GDB.
3 Copyright (C) 1986-2014 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "arch-utils.h"
25 #ifdef HAVE_SYS_FILE_H
26 #include <sys/file.h> /* needed for F_OK and friends */
28 #include "frame.h" /* required by inferior.h */
36 #include "gdbthread.h"
41 #include "readline/readline.h"
42 #include "exceptions.h"
44 #include "filenames.h"
45 #include "progspace.h"
48 #include "completer.h"
49 #include "filestuff.h"
55 /* List of all available core_fns. On gdb startup, each core file
56 register reader calls deprecated_add_core_fns() to register
57 information on each core format it is prepared to read. */
59 static struct core_fns *core_file_fns = NULL;
61 /* The core_fns for a core file handler that is prepared to read the
62 core file currently open on core_bfd. */
64 static struct core_fns *core_vec = NULL;
66 /* FIXME: kettenis/20031023: Eventually this variable should
69 static struct gdbarch *core_gdbarch = NULL;
71 /* Per-core data. Currently, only the section table. Note that these
72 target sections are *not* mapped in the current address spaces' set
73 of target sections --- those should come only from pure executable
74 or shared library bfds. The core bfd sections are an
75 implementation detail of the core target, just like ptrace is for
76 unix child targets. */
77 static struct target_section_table *core_data;
79 static void core_files_info (struct target_ops *);
81 static struct core_fns *sniff_core_bfd (bfd *);
83 static int gdb_check_format (bfd *);
85 static void core_close (struct target_ops *self);
87 static void core_close_cleanup (void *ignore);
89 static void add_to_thread_list (bfd *, asection *, void *);
91 static void init_core_ops (void);
93 void _initialize_corelow (void);
95 static struct target_ops core_ops;
97 /* An arbitrary identifier for the core inferior. */
100 /* Link a new core_fns into the global core_file_fns list. Called on
101 gdb startup by the _initialize routine in each core file register
102 reader, to register information about each format the reader is
103 prepared to handle. */
106 deprecated_add_core_fns (struct core_fns *cf)
108 cf->next = core_file_fns;
112 /* The default function that core file handlers can use to examine a
113 core file BFD and decide whether or not to accept the job of
114 reading the core file. */
117 default_core_sniffer (struct core_fns *our_fns, bfd *abfd)
121 result = (bfd_get_flavour (abfd) == our_fns -> core_flavour);
125 /* Walk through the list of core functions to find a set that can
126 handle the core file open on ABFD. Returns pointer to set that is
129 static struct core_fns *
130 sniff_core_bfd (bfd *abfd)
133 struct core_fns *yummy = NULL;
136 /* Don't sniff if we have support for register sets in
138 if (core_gdbarch && gdbarch_regset_from_core_section_p (core_gdbarch))
141 for (cf = core_file_fns; cf != NULL; cf = cf->next)
143 if (cf->core_sniffer (cf, abfd))
151 warning (_("\"%s\": ambiguous core format, %d handlers match"),
152 bfd_get_filename (abfd), matches);
154 else if (matches == 0)
155 error (_("\"%s\": no core file handler recognizes format"),
156 bfd_get_filename (abfd));
161 /* The default is to reject every core file format we see. Either
162 BFD has to recognize it, or we have to provide a function in the
163 core file handler that recognizes it. */
166 default_check_format (bfd *abfd)
171 /* Attempt to recognize core file formats that BFD rejects. */
174 gdb_check_format (bfd *abfd)
178 for (cf = core_file_fns; cf != NULL; cf = cf->next)
180 if (cf->check_format (abfd))
188 /* Discard all vestiges of any previous core file and mark data and
189 stack spaces as empty. */
192 core_close (struct target_ops *self)
196 int pid = ptid_get_pid (inferior_ptid);
197 inferior_ptid = null_ptid; /* Avoid confusion from thread
200 exit_inferior_silent (pid);
202 /* Clear out solib state while the bfd is still open. See
203 comments in clear_solib in solib.c. */
208 xfree (core_data->sections);
213 gdb_bfd_unref (core_bfd);
221 core_close_cleanup (void *ignore)
226 /* Look for sections whose names start with `.reg/' so that we can
227 extract the list of threads in a core file. */
230 add_to_thread_list (bfd *abfd, asection *asect, void *reg_sect_arg)
235 asection *reg_sect = (asection *) reg_sect_arg;
237 struct inferior *inf;
239 if (strncmp (bfd_section_name (abfd, asect), ".reg/", 5) != 0)
242 core_tid = atoi (bfd_section_name (abfd, asect) + 5);
244 pid = bfd_core_file_pid (core_bfd);
253 inf = current_inferior ();
256 inferior_appeared (inf, pid);
257 inf->fake_pid_p = fake_pid_p;
260 ptid = ptid_build (pid, lwpid, 0);
264 /* Warning, Will Robinson, looking at BFD private data! */
267 && asect->filepos == reg_sect->filepos) /* Did we find .reg? */
268 inferior_ptid = ptid; /* Yes, make it current. */
271 /* This routine opens and sets up the core file bfd. */
274 core_open (const char *arg, int from_tty)
278 struct cleanup *old_chain;
283 volatile struct gdb_exception except;
286 target_preopen (from_tty);
290 error (_("No core file specified. (Use `detach' "
291 "to stop debugging a core file.)"));
293 error (_("No core file specified."));
296 filename = tilde_expand (arg);
297 if (!IS_ABSOLUTE_PATH (filename))
299 temp = concat (current_directory, "/",
300 filename, (char *) NULL);
305 old_chain = make_cleanup (xfree, filename);
307 flags = O_BINARY | O_LARGEFILE;
312 scratch_chan = gdb_open_cloexec (filename, flags, 0);
313 if (scratch_chan < 0)
314 perror_with_name (filename);
316 temp_bfd = gdb_bfd_fopen (filename, gnutarget,
317 write_files ? FOPEN_RUB : FOPEN_RB,
319 if (temp_bfd == NULL)
320 perror_with_name (filename);
322 if (!bfd_check_format (temp_bfd, bfd_core)
323 && !gdb_check_format (temp_bfd))
325 /* Do it after the err msg */
326 /* FIXME: should be checking for errors from bfd_close (for one
327 thing, on error it does not free all the storage associated
329 make_cleanup_bfd_unref (temp_bfd);
330 error (_("\"%s\" is not a core dump: %s"),
331 filename, bfd_errmsg (bfd_get_error ()));
334 /* Looks semi-reasonable. Toss the old core file and work on the
337 do_cleanups (old_chain);
338 unpush_target (&core_ops);
340 old_chain = make_cleanup (core_close_cleanup, 0 /*ignore*/);
342 core_gdbarch = gdbarch_from_bfd (core_bfd);
344 /* Find a suitable core file handler to munch on core_bfd */
345 core_vec = sniff_core_bfd (core_bfd);
349 core_data = XCNEW (struct target_section_table);
351 /* Find the data section */
352 if (build_section_table (core_bfd,
353 &core_data->sections,
354 &core_data->sections_end))
355 error (_("\"%s\": Can't find sections: %s"),
356 bfd_get_filename (core_bfd), bfd_errmsg (bfd_get_error ()));
358 /* If we have no exec file, try to set the architecture from the
359 core file. We don't do this unconditionally since an exec file
360 typically contains more information that helps us determine the
361 architecture than a core file. */
363 set_gdbarch_from_file (core_bfd);
365 push_target (&core_ops);
366 discard_cleanups (old_chain);
368 /* Do this before acknowledging the inferior, so if
369 post_create_inferior throws (can happen easilly if you're loading
370 a core file with the wrong exec), we aren't left with threads
371 from the previous inferior. */
374 inferior_ptid = null_ptid;
376 /* Need to flush the register cache (and the frame cache) from a
377 previous debug session. If inferior_ptid ends up the same as the
378 last debug session --- e.g., b foo; run; gcore core1; step; gcore
379 core2; core core1; core core2 --- then there's potential for
380 get_current_regcache to return the cached regcache of the
381 previous session, and the frame cache being stale. */
382 registers_changed ();
384 /* Build up thread list from BFD sections, and possibly set the
385 current thread to the .reg/NN section matching the .reg
387 bfd_map_over_sections (core_bfd, add_to_thread_list,
388 bfd_get_section_by_name (core_bfd, ".reg"));
390 if (ptid_equal (inferior_ptid, null_ptid))
392 /* Either we found no .reg/NN section, and hence we have a
393 non-threaded core (single-threaded, from gdb's perspective),
394 or for some reason add_to_thread_list couldn't determine
395 which was the "main" thread. The latter case shouldn't
396 usually happen, but we're dealing with input here, which can
397 always be broken in different ways. */
398 struct thread_info *thread = first_thread_of_process (-1);
402 inferior_appeared (current_inferior (), CORELOW_PID);
403 inferior_ptid = pid_to_ptid (CORELOW_PID);
404 add_thread_silent (inferior_ptid);
407 switch_to_thread (thread->ptid);
410 post_create_inferior (&core_ops, from_tty);
412 /* Now go through the target stack looking for threads since there
413 may be a thread_stratum target loaded on top of target core by
414 now. The layer above should claim threads found in the BFD
416 TRY_CATCH (except, RETURN_MASK_ERROR)
418 target_find_new_threads ();
421 if (except.reason < 0)
422 exception_print (gdb_stderr, except);
424 p = bfd_core_file_failing_command (core_bfd);
426 printf_filtered (_("Core was generated by `%s'.\n"), p);
428 /* Clearing any previous state of convenience variables. */
429 clear_exit_convenience_vars ();
431 siggy = bfd_core_file_failing_signal (core_bfd);
434 /* If we don't have a CORE_GDBARCH to work with, assume a native
435 core (map gdb_signal from host signals). If we do have
436 CORE_GDBARCH to work with, but no gdb_signal_from_target
437 implementation for that gdbarch, as a fallback measure,
438 assume the host signal mapping. It'll be correct for native
439 cores, but most likely incorrect for cross-cores. */
440 enum gdb_signal sig = (core_gdbarch != NULL
441 && gdbarch_gdb_signal_from_target_p (core_gdbarch)
442 ? gdbarch_gdb_signal_from_target (core_gdbarch,
444 : gdb_signal_from_host (siggy));
446 printf_filtered (_("Program terminated with signal %s, %s.\n"),
447 gdb_signal_to_name (sig), gdb_signal_to_string (sig));
449 /* Set the value of the internal variable $_exitsignal,
450 which holds the signal uncaught by the inferior. */
451 set_internalvar_integer (lookup_internalvar ("_exitsignal"),
455 /* Fetch all registers from core file. */
456 target_fetch_registers (get_current_regcache (), -1);
458 /* Now, set up the frame cache, and print the top of stack. */
459 reinit_frame_cache ();
460 print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
464 core_detach (struct target_ops *ops, const char *args, int from_tty)
467 error (_("Too many arguments"));
469 reinit_frame_cache ();
471 printf_filtered (_("No core file now.\n"));
474 /* Try to retrieve registers from a section in core_bfd, and supply
475 them to core_vec->core_read_registers, as the register set numbered
478 If inferior_ptid's lwp member is zero, do the single-threaded
479 thing: look for a section named NAME. If inferior_ptid's lwp
480 member is non-zero, do the multi-threaded thing: look for a section
481 named "NAME/LWP", where LWP is the shortest ASCII decimal
482 representation of inferior_ptid's lwp member.
484 HUMAN_NAME is a human-readable name for the kind of registers the
485 NAME section contains, for use in error messages.
487 If REQUIRED is non-zero, print an error if the core file doesn't
488 have a section by the appropriate name. Otherwise, just do
492 get_core_register_section (struct regcache *regcache,
495 const char *human_name,
498 static char *section_name = NULL;
499 struct bfd_section *section;
503 xfree (section_name);
505 if (ptid_get_lwp (inferior_ptid))
506 section_name = xstrprintf ("%s/%ld", name,
507 ptid_get_lwp (inferior_ptid));
509 section_name = xstrdup (name);
511 section = bfd_get_section_by_name (core_bfd, section_name);
515 warning (_("Couldn't find %s registers in core file."),
520 size = bfd_section_size (core_bfd, section);
521 contents = alloca (size);
522 if (! bfd_get_section_contents (core_bfd, section, contents,
525 warning (_("Couldn't read %s registers from `%s' section in core file."),
530 if (core_gdbarch && gdbarch_regset_from_core_section_p (core_gdbarch))
532 const struct regset *regset;
534 regset = gdbarch_regset_from_core_section (core_gdbarch,
539 warning (_("Couldn't recognize %s registers in core file."),
544 regset->supply_regset (regset, regcache, -1, contents, size);
548 gdb_assert (core_vec);
549 core_vec->core_read_registers (regcache, contents, size, which,
551 bfd_section_vma (core_bfd, section)));
555 /* Get the registers out of a core file. This is the machine-
556 independent part. Fetch_core_registers is the machine-dependent
557 part, typically implemented in the xm-file for each
560 /* We just get all the registers, so we don't use regno. */
563 get_core_registers (struct target_ops *ops,
564 struct regcache *regcache, int regno)
566 struct core_regset_section *sect_list;
569 if (!(core_gdbarch && gdbarch_regset_from_core_section_p (core_gdbarch))
570 && (core_vec == NULL || core_vec->core_read_registers == NULL))
572 fprintf_filtered (gdb_stderr,
573 "Can't fetch registers from this type of core file\n");
577 sect_list = gdbarch_core_regset_sections (get_regcache_arch (regcache));
579 while (sect_list->sect_name != NULL)
581 if (strcmp (sect_list->sect_name, ".reg") == 0)
582 get_core_register_section (regcache, sect_list->sect_name,
583 0, sect_list->human_name, 1);
584 else if (strcmp (sect_list->sect_name, ".reg2") == 0)
585 get_core_register_section (regcache, sect_list->sect_name,
586 2, sect_list->human_name, 0);
588 get_core_register_section (regcache, sect_list->sect_name,
589 3, sect_list->human_name, 0);
596 get_core_register_section (regcache,
597 ".reg", 0, "general-purpose", 1);
598 get_core_register_section (regcache,
599 ".reg2", 2, "floating-point", 0);
602 /* Mark all registers not found in the core as unavailable. */
603 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
604 if (regcache_register_status (regcache, i) == REG_UNKNOWN)
605 regcache_raw_supply (regcache, i, NULL);
609 core_files_info (struct target_ops *t)
611 print_section_info (core_data, core_bfd);
624 add_to_spuid_list (bfd *abfd, asection *asect, void *list_p)
626 struct spuid_list *list = list_p;
627 enum bfd_endian byte_order
628 = bfd_big_endian (abfd) ? BFD_ENDIAN_BIG : BFD_ENDIAN_LITTLE;
631 sscanf (bfd_section_name (abfd, asect), "SPU/%d/regs%n", &fd, &pos);
635 if (list->pos >= list->offset && list->pos + 4 <= list->offset + list->len)
637 store_unsigned_integer (list->buf + list->pos - list->offset,
644 /* Read siginfo data from the core, if possible. Returns -1 on
645 failure. Otherwise, returns the number of bytes read. ABFD is the
646 core file's BFD; READBUF, OFFSET, and LEN are all as specified by
647 the to_xfer_partial interface. */
650 get_core_siginfo (bfd *abfd, gdb_byte *readbuf, ULONGEST offset, ULONGEST len)
654 const char *name = ".note.linuxcore.siginfo";
656 if (ptid_get_lwp (inferior_ptid))
657 section_name = xstrprintf ("%s/%ld", name,
658 ptid_get_lwp (inferior_ptid));
660 section_name = xstrdup (name);
662 section = bfd_get_section_by_name (abfd, section_name);
663 xfree (section_name);
667 if (!bfd_get_section_contents (abfd, section, readbuf, offset, len))
673 static enum target_xfer_status
674 core_xfer_partial (struct target_ops *ops, enum target_object object,
675 const char *annex, gdb_byte *readbuf,
676 const gdb_byte *writebuf, ULONGEST offset,
677 ULONGEST len, ULONGEST *xfered_len)
681 case TARGET_OBJECT_MEMORY:
682 return section_table_xfer_memory_partial (readbuf, writebuf,
683 offset, len, xfered_len,
685 core_data->sections_end,
688 case TARGET_OBJECT_AUXV:
691 /* When the aux vector is stored in core file, BFD
692 represents this with a fake section called ".auxv". */
694 struct bfd_section *section;
697 section = bfd_get_section_by_name (core_bfd, ".auxv");
699 return TARGET_XFER_E_IO;
701 size = bfd_section_size (core_bfd, section);
703 return TARGET_XFER_EOF;
709 return TARGET_XFER_EOF;
710 if (!bfd_get_section_contents (core_bfd, section, readbuf,
711 (file_ptr) offset, size))
713 warning (_("Couldn't read NT_AUXV note in core file."));
714 return TARGET_XFER_E_IO;
717 *xfered_len = (ULONGEST) size;
718 return TARGET_XFER_OK;
720 return TARGET_XFER_E_IO;
722 case TARGET_OBJECT_WCOOKIE:
725 /* When the StackGhost cookie is stored in core file, BFD
726 represents this with a fake section called
729 struct bfd_section *section;
732 section = bfd_get_section_by_name (core_bfd, ".wcookie");
734 return TARGET_XFER_E_IO;
736 size = bfd_section_size (core_bfd, section);
744 return TARGET_XFER_EOF;
745 if (!bfd_get_section_contents (core_bfd, section, readbuf,
746 (file_ptr) offset, size))
748 warning (_("Couldn't read StackGhost cookie in core file."));
749 return TARGET_XFER_E_IO;
752 *xfered_len = (ULONGEST) size;
753 return TARGET_XFER_OK;
756 return TARGET_XFER_E_IO;
758 case TARGET_OBJECT_LIBRARIES:
760 && gdbarch_core_xfer_shared_libraries_p (core_gdbarch))
763 return TARGET_XFER_E_IO;
766 *xfered_len = gdbarch_core_xfer_shared_libraries (core_gdbarch,
770 if (*xfered_len == 0)
771 return TARGET_XFER_EOF;
773 return TARGET_XFER_OK;
778 case TARGET_OBJECT_LIBRARIES_AIX:
780 && gdbarch_core_xfer_shared_libraries_aix_p (core_gdbarch))
783 return TARGET_XFER_E_IO;
787 = gdbarch_core_xfer_shared_libraries_aix (core_gdbarch,
791 if (*xfered_len == 0)
792 return TARGET_XFER_EOF;
794 return TARGET_XFER_OK;
799 case TARGET_OBJECT_SPU:
800 if (readbuf && annex)
802 /* When the SPU contexts are stored in a core file, BFD
803 represents this with a fake section called
806 struct bfd_section *section;
808 char sectionstr[100];
810 xsnprintf (sectionstr, sizeof sectionstr, "SPU/%s", annex);
812 section = bfd_get_section_by_name (core_bfd, sectionstr);
814 return TARGET_XFER_E_IO;
816 size = bfd_section_size (core_bfd, section);
818 return TARGET_XFER_EOF;
824 return TARGET_XFER_EOF;
825 if (!bfd_get_section_contents (core_bfd, section, readbuf,
826 (file_ptr) offset, size))
828 warning (_("Couldn't read SPU section in core file."));
829 return TARGET_XFER_E_IO;
832 *xfered_len = (ULONGEST) size;
833 return TARGET_XFER_OK;
837 /* NULL annex requests list of all present spuids. */
838 struct spuid_list list;
841 list.offset = offset;
845 bfd_map_over_sections (core_bfd, add_to_spuid_list, &list);
847 if (list.written == 0)
848 return TARGET_XFER_EOF;
851 *xfered_len = (ULONGEST) list.written;
852 return TARGET_XFER_OK;
855 return TARGET_XFER_E_IO;
857 case TARGET_OBJECT_SIGNAL_INFO:
860 LONGEST l = get_core_siginfo (core_bfd, readbuf, offset, len);
865 return TARGET_XFER_OK;
868 return TARGET_XFER_E_IO;
871 return ops->beneath->to_xfer_partial (ops->beneath, object,
873 writebuf, offset, len,
879 /* If mourn is being called in all the right places, this could be say
880 `gdb internal error' (since generic_mourn calls
881 breakpoint_init_inferior). */
884 ignore (struct target_ops *ops, struct gdbarch *gdbarch,
885 struct bp_target_info *bp_tgt)
891 /* Okay, let's be honest: threads gleaned from a core file aren't
892 exactly lively, are they? On the other hand, if we don't claim
893 that each & every one is alive, then we don't get any of them
894 to appear in an "info thread" command, which is quite a useful
898 core_thread_alive (struct target_ops *ops, ptid_t ptid)
903 /* Ask the current architecture what it knows about this core file.
904 That will be used, in turn, to pick a better architecture. This
905 wrapper could be avoided if targets got a chance to specialize
908 static const struct target_desc *
909 core_read_description (struct target_ops *target)
911 if (core_gdbarch && gdbarch_core_read_description_p (core_gdbarch))
913 const struct target_desc *result;
915 result = gdbarch_core_read_description (core_gdbarch,
921 return target->beneath->to_read_description (target->beneath);
925 core_pid_to_str (struct target_ops *ops, ptid_t ptid)
928 struct inferior *inf;
931 /* The preferred way is to have a gdbarch/OS specific
934 && gdbarch_core_pid_to_str_p (core_gdbarch))
935 return gdbarch_core_pid_to_str (core_gdbarch, ptid);
937 /* Otherwise, if we don't have one, we'll just fallback to
938 "process", with normal_pid_to_str. */
940 /* Try the LWPID field first. */
941 pid = ptid_get_lwp (ptid);
943 return normal_pid_to_str (pid_to_ptid (pid));
945 /* Otherwise, this isn't a "threaded" core -- use the PID field, but
946 only if it isn't a fake PID. */
947 inf = find_inferior_pid (ptid_get_pid (ptid));
948 if (inf != NULL && !inf->fake_pid_p)
949 return normal_pid_to_str (ptid);
951 /* No luck. We simply don't have a valid PID to print. */
952 xsnprintf (buf, sizeof buf, "<main task>");
957 core_has_memory (struct target_ops *ops)
959 return (core_bfd != NULL);
963 core_has_stack (struct target_ops *ops)
965 return (core_bfd != NULL);
969 core_has_registers (struct target_ops *ops)
971 return (core_bfd != NULL);
974 /* Implement the to_info_proc method. */
977 core_info_proc (struct target_ops *ops, const char *args,
978 enum info_proc_what request)
980 struct gdbarch *gdbarch = get_current_arch ();
982 /* Since this is the core file target, call the 'core_info_proc'
983 method on gdbarch, not 'info_proc'. */
984 if (gdbarch_core_info_proc_p (gdbarch))
985 gdbarch_core_info_proc (gdbarch, args, request);
988 /* Fill in core_ops with its defined operations and properties. */
993 core_ops.to_shortname = "core";
994 core_ops.to_longname = "Local core dump file";
996 "Use a core file as a target. Specify the filename of the core file.";
997 core_ops.to_open = core_open;
998 core_ops.to_close = core_close;
999 core_ops.to_detach = core_detach;
1000 core_ops.to_fetch_registers = get_core_registers;
1001 core_ops.to_xfer_partial = core_xfer_partial;
1002 core_ops.to_files_info = core_files_info;
1003 core_ops.to_insert_breakpoint = ignore;
1004 core_ops.to_remove_breakpoint = ignore;
1005 core_ops.to_thread_alive = core_thread_alive;
1006 core_ops.to_read_description = core_read_description;
1007 core_ops.to_pid_to_str = core_pid_to_str;
1008 core_ops.to_stratum = process_stratum;
1009 core_ops.to_has_memory = core_has_memory;
1010 core_ops.to_has_stack = core_has_stack;
1011 core_ops.to_has_registers = core_has_registers;
1012 core_ops.to_info_proc = core_info_proc;
1013 core_ops.to_magic = OPS_MAGIC;
1016 internal_error (__FILE__, __LINE__,
1017 _("init_core_ops: core target already exists (\"%s\")."),
1018 core_target->to_longname);
1019 core_target = &core_ops;
1023 _initialize_corelow (void)
1027 add_target_with_completer (&core_ops, filename_completer);