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
|
aminet net>