Searching for Files and Directories

Hopper has a powerful search operation that allows searching of file properties, and, in some cases, content. To initiate a search use the Ops -> Search... menu item. The resulting dialog opens to the search definition tab. Use the form to construct your search query. If you're searching a Unix host the option to search file content is available. On non-Unix hosts this option is not available.

Search Manager Dialog

The Search Manager Dialog displays a one-line summary of search jobs initiated in the current Hopper session. You can display the Search Manager window at any time via the Windows -> Search Manager menu item.

To see additional details about a particular search job, press the "info" icon or double click on the job's status line. To abort a search job, highlight the job(s) and press the Abort button. To adopt jobs that were initiated in previous Hopper sessions, press the Adopt Jobs button.

Search Dialog

The Search window has tabs that allow you to define a search, view search results, and view search diagnostics. It is displayed when you initiate a new search via the Ops->Search menu item.

Search Tab

The Search tab is the first you see when you invoke a new search. This tab allows you to set the starting directory for the search, which will default to the directory you were viewing when you started the search.
The search rules section allows you to specify the criteria for which you are looking. There are many options for different criteria as well as different comparisons. For example, the filename search supports these comparisons:

  • Unix glob wildcards ("matches") [DEFAULT]
  • Exact match ("matches")
  • A string embedded in the middle of a filename ("contains")
  • A filename that starts with the given string ("starts with")
  • A filename that ends with the given string ("ends with")

On Unix hosts one can also search the file contents with the "Contains text" criteria. Searches can be case sensitive or insensitive.

Note that search rules can be saved for future use; this makes reissuing complex searches much easier. Also note that searches can be configured to show the line numbers from the resulting files as well as to optionally show lines of context around matching content.

Search Results Tab

The Results Tab shows the results of the given search. The Progress section describes the search in a high-level, including how many hits were found and the final status. The Hits section lists the files that met the search criteria. You can highlight these files and use the right-mouse menu to operate upon the search hits. If you did a content search, the Content section will show the matching content from the file selected in the Hits section.

Additional lines of context will be shown if you selected that option. In this example, one line of context was added:

To abort an active job, press the Abort Search button. To save the diagnostic messages, use the Save button.

Search Diagnostics Tab

The Search Diagnostics tab will display any warnings or errors that occurred during the search operation. If the search job status was "Done w/errors", you should check the Diagnostics tab to see what kind of problem was encountered.