Short: Shows sorted & text-formatted dir list. Author: Marko K. Seppänen Uploader: Marko K. Seppänen Type: util/shell Version: 0.982 Replaces: util/shell/ShowFiles Requires: locale.library V48+ or DOS V50.36+ if locale not available Architecture: ppc-amigaos >= 4.0.0 Kurz: Zeigt eine sortierte liste & text-format. URL: http://www.m4rko.com/AMIGA ShowFiles (sf) - 0.982 ====================== DIR/LIST command - displays a sorted and text-formatted list. Requirements ------------ AOS4 (requires locale.library V48+ or DOS V50.36+ if locale not available). AmigaOS 4.1 FE recommended. Description ----------- ShowFiles (sf) is yet another DIR command (written in C). It displays a sorted and text-formatted list of files, drawers (dirs) and soft/hard-links on disk or other storage medium. It will also display their additional information such as size, date, possible comment, executable header type (68k or PPC program), protection-bits, etc, etc. It supports a number of different option/switch formats (Amiga like switches, Unix/Linux style and DOS/Windows style). It also supports wildcards/pattern- matching and Amiga templates. After installation, in the Shell, please type "sf HELP" (or "sf --help") for listing all options/switches. Or look in the .doc-file in the archive. Features -------- - Abbreviated as SF or just sf, fast and easy to type in the shell. - Dirs/drawers are displayed in blue color (pen 3). - Hard/Softlinks are displayed underscored (underlined). - Shows where any Hard/Softlinks points to. - Possible comments are displayed in italic. - Displays the "primitive" file type of files. - Fetches and identifies executable headers. 68k, PPC (ELF), EXE, among others. - Displays the Amiga file protection bits of files. - Shows free disk space and sizes in KiB (1024), kB (1000) and bytes. - Options SIZE and TIME, for sorting by size and time/date. - Option REVERSE, for reversing the output list. - Options (FILES, DIRS & LINKS) for displaying only files, dirs or links. Or intermix them. - Option 68K, for only listing m680x0 (68k) executables (AmigaOS 3.x). - Option PPC, for only listing PowerPC (PPC) executables (ELF headers). - Option ALL, for showing all files and dirs in directories and subdirs. - Option to "trail" files with an initial character ('/', '*' or (at)-char). - Possibility to specify a path to display. - Supports wildcards/pattern-matching. - Option BARE, for listing without heading/summary information. - Shows OwnerUID, OwnerGID and ObjectID (as reported by DOS). - Supports the ? switch, for showing the Amiga Template. - Option DATEFIRST for having the date first in every line. - Option REALDATES for dates in the international format YYYY-MM-DD. - Supports multiple formats of options/switches (f.ex: TIME --time -t /t). - Supports automatic updates through AmiUpdate. - Supports Shell/Console with black (pen 1) background. - Written (in C) and developed on Amiga, for Amiga and Amigans. Special notes for this release ------------------------------ - This release is a minor bugfix release. - Added SETBLACKBG command for setting the background color to black (pen 1), when using a Shell with black background. - NOTE: Option CLARIFY is now deprecated, please use MOST instead. - NOTE: Option REALDATE is now deprecated, please use REALDATES instead. - NOTE: No footer info implemented yet when pattern matching.. - All one-single-letter options such as a, -m, /P are now case sensitive, where as non-single-letter options are not. Reason for this is because available free letters are becomming scarce for more options. - For the manual (info and details), see the .doc-file in the archive. - For the latest changes/updates, look in the Changes-section in the manual... Displaying dir-listings ----------------------- There are 3 main OUTPUT VIEWS for displaying dir-listings, typing the following (without the "1>" string): 1> sf = displays all the files in current dir with the *DEFAULT* view. 1> sf MORE or 1> sf -m = displays a list with more specific information including what exe type a file is (PPC (ELF), 68k, exe etc.) 1> sf MOST or 1> sf -M = displays an even more clarified list of specific information. More examples ------------- Options can be written in any of the four different types. For example MORE, --MORE, -m, /m, more and --more, are all the same option. However, one single letter options such as m, -p, P, /H, etc are case- sensitive, non-single letter options are not. 1> sf 68K or 1> sf -6 = lists only 68K executables. 1> sf TIME or 1> sf -t = sorts by time/date (oldest first). 1> sf TIME REVERSE or 1> sf -t -r = sorts by time/date (newest/latest first). 1> sf DIRS or 1> sf -d = displays only drawers (dirs). 1> sf SIZE REVERSE or 1> sf -s -r = displays a list of files sorted by size, the biggest at the top. 1> sf ALL or 1> sf -a = displays all files and dirs in a directory and its sub-directories. 1> sf sobjs: -l -c = displays only links in the dir/assignment called sobjs: 1> sf HELP or 1> sf --help or 1> sf -? or 1> sf /? = displays the help with a list of all switches/commands. 1> sf ram:t/n#? = displays all files and dirs in RAM:T starting with character n. Limitations ----------- - No footer info implemented yet when pattern matching. - When fetching for exe-files (using MORE or CLARIFY option, sf doesn't (yet) recognize the architecture for MacOS files, it does only recognize if it's an exe-file (for what ever architecture) or not.) Installation ------------ Just run the file ShowFiles.Install, or: * Copy the file ShowFiles to your C: * Type the following and hit enter: C:MakeLink C:sf C:ShowFiles SOFT FORCE * Copy the documentation to SYS:Documentation/C/ * Done! Milestones and major events --------------------------- 2016 Feb, version 0.981 - Fixed so sf works with Shells/Consoles with black background. 2015 Jul, version 0.970 - Pattern matching implemented. 2014 Feb, version 0.943 - A rare bug with option ALL (recursive dirs) found, and tested on A1-X1000, Sam460ex and Sam440ep-flex. Bug caused by a compiler switch. 2013 Dec, version 0.923 - All major/minor typos, quirks and bugs resolved in all scripts (AutoInstall, Install and UnInstall scripts). 2012 Nov, version 0.8 - Renamed to ShowFiles (SF/sf) from DF (DisplayFiles), due to a name-clash. 2011 Feb, version Beta 5, (0.5) - AmiUpdate implemetation completed and fully working autoinstall. 2011 Feb, version Beta 2 - Dynamic memory allocation for storing file meta data (dir listing handling), no more "max limit of 1000 files". 2011 Jan, version Alpha 1 - First public release. Changes ------- Version 0.982: (Feb 2016) - Fixed missing command (BARE) in the Template output and manual, it was in HELP and readme though. - Fixed so the Template is alphabetically sorted. - Fixed more contrast to the arrow (->) in links, color changed to black. - Fixed missing REALDATES and DATEFIRST in features in readme. Version 0.981: (Feb 2016) - Fixed "sometimes missing footer" (appeared in the wrong color). Thanks Guillaume (zzd10h) for reporting. - Fixed wrong colors in comments when black Shell. Thanks Guillaume (zzd10h) for reporting. (PS: Option for omitting comments already on TODO-list.) - Fixed issue, "A block of text appeared in the wrong place in the readme". - Fixed a few missing commands in the Template output in help and in manual. Version 0.980: (Feb 2016) - Added MOST aka -M option, same as CLARIFY and -c, but easier to remember. - Added SETBLACKBG command for setting the background color to black (pen 1), when using a Shell with black background. - Added SETNORMALBG command for setting the background color to normal (grey, pen 0), when using a Shell with normal/grey background. - Added PRINTENV command for printing out the ShowFiles (sf) environment/ configuration variables. - The option REALDATE is now deprecated, please use REALDATES instead. - Included all error codes and their meaning to the manual. - A number of typos fixed in readme. Version 0.972: (Sep 2015) - Compiled with latest SDK version 53.29. - Fixed case sensitive issue with pattern matching. (thanks Guillaume (zzd10h) for reporting) - Fixed a rare condition where header whould not render correctly. - UseCount removed from output, DOS structure no longer support it. Version 0.971: (Jul 2015) - Fixed bug, pattern matching in current dir failed. Version 0.970: (Jul 2015) - Pattern matching implemented. - Fixed bug, header background-color sometimes smearing to next line. - Fixed issue with template and option/command-info-format, a few working commands/options were missing in the printed output. - Fixed APP-string/name, leftover garbage ("DEBUG") removed from the string. - Included output of the EXTVER-tag to the version/help output. Version 0.960: (Sep 2014) - Added ? switch for showing the Template, suggested by JosDuchIt. - Added BARE option, for using bare format (no heading/summary information). - Safety improved, added more checks concerning memory (just to be sure). (Sentinels placed around memory allocations, about 20 in total.) - Corrected information in the HELP option. - Typos fixed in the Options-section and in the Readme file. - Added Format-info and Template-info to documentation. - Added small hidden message to binary (only #JustForFun, ~60 chars). - Added Milestones-section to documentation. Version 0.950: (Jun 2014) - Added REALDATE command, shows Date in international format (yyyy-mm-dd), suggested by JosDuchIt. - Added DATEFIRST command, Date (and Time) column is as first column, sort of suggested by JosDuchIt. - Bugfix/change: The few first protectionbits are seen now again in MORE view. This was little "too much of a feature" that looked broken. - Bugfix/change: The three first columns in the DEFAULT view removed, yes those should not be seen, please use option MORE instead to see those as well. - Added Extversion (EXTVER) tag/cookie. - Minor fixes in readme, among other small fixes. Version 0.943: (Feb 2014) - Bugfixed option ALL. This exact compile was *VERIFIED* thanks to Guillaume Boesel (zzd10h) on his A1-X1000 and Joel Edberg (Joeled) on his Sam460ex, and also tested on author's Sam440ep-flex. The bug was due to a compiler optimization switch. Version 0.942: (Feb 2014) - Bugfixed option ALL. (Edit: No bummer, still something fishy, sorry.) Version 0.942d1: (Feb 2014) - Debug-version for option ALL. (Thanks for testing Guillaume Boesel (zzd10h) on AmigaOne X1000 and Joel Edberg (Joeled) for testing on Sam460ex. Also runs fine on my (the author's) Sam440ep-flex with AmigaOS 4.1 Update 6.) Version 0.941: (Jan 2014) - AmiUpdate fix, AutoInstall file included again, it did escape for some mysterious reason ( ;) ) in the last archive. (Thanks zzd10h) ...//snip// (See the doc/manual for more information.) Thank You --------- Thank you to everyone giving help, feedback, bug/error-reports and suggestions. Individual credits are in history body text. Licence ------- This software is freeware. Donation -------- Feel free to make a donation by using PayPal: marko . seppanen // g m a i l. com (without spaces) Author ------ Marko K. Seppänen Homepage -------- http://m4rko.com/amiga