Apple-2-Tools/nulib2
1
0
Fork 0
mirror of https://github.com/fadden/nulib2.git synced 2024-12-29 15:29:16 +00:00
Code Issues Projects Releases Wiki Activity

Note reversal of MFS and HFS

Browse Source 
The NuFX spec reversed the entries for MFS and HFS.  Not a significant
issue, but worth pointing out.
This commit is contained in:
Andy McFadden 2022-05-25 11:34:10 -07:00
parent 01abf8e920
commit 33a9e06ddc
1 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
library/nufx-addendum.htm
View File

@ -24,12 +24,13 @@
<!--msnavigation--><msnavigation border="0" cellpadding="0" cellspacing="0" dir="ltr" width="100%"><tr><!--msnavigation--><msnavigation valign="top"><msnavigation border="0" cellpadding="0" cellspacing="0" width="100%"><msnavigation border="0" cellpadding="0" cellspacing="0" dir="ltr" width="100%"><tr><msnavigation valign="top"><msnavigation border="0" cellpadding="0" cellspacing="0" width="100%"><msnavigation border="0" cellpadding="0" cellspacing="0" width="100%"><tr><msnavigation valign="top"> <!--msnavigation--><msnavigation border="0" cellpadding="0" cellspacing="0" dir="ltr" width="100%"><tr><!--msnavigation--><msnavigation valign="top"><msnavigation border="0" cellpadding="0" cellspacing="0" width="100%"><msnavigation border="0" cellpadding="0" cellspacing="0" dir="ltr" width="100%"><tr><msnavigation valign="top"><msnavigation border="0" cellpadding="0" cellspacing="0" width="100%"><msnavigation border="0" cellpadding="0" cellspacing="0" width="100%"><tr><msnavigation valign="top">
<h6>NuFX Addendum - <b>By Andy McFadden - Last revised 2015/01/09</b></h6> <h6>NuFX Addendum - <b>By Andy McFadden - Last revised 2022/05/25</b></h6>
<p align="left">This addendum clarifies and extends certain aspects of the <a href="FTN.e08002.htm"> NuFX <p align="left">This addendum clarifies and extends certain aspects of the <a href="FTN.e08002.htm"> NuFX
specification</a>.&nbsp; This is not an &quot;official&quot; modification specification</a>.&nbsp; This is not an &quot;official&quot; modification
of the original document - it has not been reviewed and approved by of the original document - it has not been reviewed and approved by
the original author - but anyone developing NuFX utilities would do the original author - but anyone developing NuFX utilities would do
well to follow these recommendations.</p> well to follow these recommendations.</p>
<h2 align="left">Purpose</h2> <h2 align="left">Purpose</h2>
<p align="left">The NuFX specification defines&nbsp;a very loose structure, and <p align="left">The NuFX specification defines&nbsp;a very loose structure, and
leaves much to the imagination of the implementer.&nbsp; For example, &quot;If a leaves much to the imagination of the implementer.&nbsp; For example, &quot;If a
@ -428,20 +429,27 @@ or CRLF, and convert as needed for display.&nbsp; GS/ShrinkIt used a
proportional font, so there is no need to worry about formatting to preserve &quot;ASCII art&quot; in proportional font, so there is no need to worry about formatting to preserve &quot;ASCII art&quot; in
comments.</p> comments.</p>
<p align="left">&nbsp;</p> <p align="left">&nbsp;</p>
<h3 align="left">GS/OS option lists</h3> <h3 align="left">GS/OS option lists</h3>
<p align="left">Files archived from HFS AppleShare volumes come with <p align="left">Files archived from HFS AppleShare volumes come with
&quot;option lists&quot;, a GS/OS feature that provides a way for non-ProDOS &quot;option lists&quot;, a GS/OS feature that provides a way for non-ProDOS
filesystem information to be preserved.&nbsp; GS/ShrinkIt tries to save this filesystem information to be preserved (e.g. the HFS FInfo and FXInfo data).
information, but it doesn't seem to do a very good job.&nbsp; It appears to drop GS/ShrinkIt tries to save this information, but it doesn't seem to do a very good job.
a big chunk of the data without altering the size (e.g. the size field says 36 Sometimes it appears to drop some of the data without altering the size, e.g. the
bytes, but there's only space for 18 bytes in the record header).</p> size field says 36 bytes, but there's only space for 18 bytes in the record header.
(ProDOS technote #25 suggests this could relate to the ProDOS FSM on
a Macintosh with a //e card.)</p>
<p align="left">GS/ShrinkIt seems to work correctly whether the option list size <p align="left">GS/ShrinkIt seems to work correctly whether the option list size
is correct or not, so other applications should do the same.</p> is correct or not, so other applications should do the same.</p>
<p>Side note: the NuFX specification reversed the values of MFS and HFS
in the file_sys_id definition. In practice, GS/ShrinkIt correctly uses the
GS/OS FST definitions: MFS=5, HFS=6.</p>
<p align="left"><b>Opening:</b> Assume the option_size field is correct <p align="left"><b>Opening:</b> Assume the option_size field is correct
unless it exceeds attrib_count-2.&nbsp; If it's too large, clip it down to size.</p> unless it exceeds attrib_count-2.&nbsp; If it's too large, clip it down to size.</p>
<p align="left"><b>Updating:</b> Always use the actual size.&nbsp; Do not <p align="left"><b>Updating:</b> Always use the actual size.&nbsp; Do not
propagate incorrect values.&nbsp; Discarding existing option lists is propagate incorrect values.&nbsp; Discarding existing option lists is
discouraged but allowed.</p> discouraged but allowed.</p>
<p align="left">&nbsp;</p> <p align="left">&nbsp;</p>
<h3 align="left">Master EOF</h3> <h3 align="left">Master EOF</h3>
<p align="left">For the most part, ShrinkIt correctly sets the MasterEOF field <p align="left">For the most part, ShrinkIt correctly sets the MasterEOF field