xref: /dflybsd-src/contrib/file/MAINT (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino$File: MAINT,v 1.10 2008/02/05 19:08:11 christos Exp $
286d7f5d3SJohn Marino
386d7f5d3SJohn MarinoMaintenance notes:
486d7f5d3SJohn Marino
586d7f5d3SJohn MarinoI am continuing to maintain the file command. I welcome your help,
686d7f5d3SJohn Marinobut to make my life easier I'd like to request the following:
786d7f5d3SJohn Marino
886d7f5d3SJohn Marino- Do not distribute changed versions.
986d7f5d3SJohn Marino
1086d7f5d3SJohn MarinoPeople trying to be helpful occasionally put up their hacked versions
1186d7f5d3SJohn Marinoof the file command for anonymous FTP, and people all over the
1286d7f5d3SJohn Marinoworld get copies of the hacked versions.  Within a day or two I am
1386d7f5d3SJohn Marinogetting email from around the world asking me why "my" file command
1486d7f5d3SJohn Marinowon't compile!!! Needless to say this detracts from the limited
1586d7f5d3SJohn Marinotime I have available to work on the actual software. Therefore I
1686d7f5d3SJohn Marinoask you again to please NOT distribute your changed version. If
1786d7f5d3SJohn Marinoyou need to make changes, please add a patch file next to the
1886d7f5d3SJohn Marinodistribution tar, and a README file that clearly explains what you
1986d7f5d3SJohn Marinoare trying to fix.
2086d7f5d3SJohn Marino
2186d7f5d3SJohn MarinoThank you for your assistance and cooperation.
2286d7f5d3SJohn Marino
2386d7f5d3SJohn MarinoCode Overview
2486d7f5d3SJohn Marino
2586d7f5d3SJohn MarinoThis is a rough idea of the control flow from the main program:
2686d7f5d3SJohn Marino
2786d7f5d3SJohn Marinofile.c	main()
2886d7f5d3SJohn Marinofile.c	process (called for each file)
2986d7f5d3SJohn Marino		printf file name
3086d7f5d3SJohn Marinomagic.c		magic_file()
3186d7f5d3SJohn Marinofsmagic.c		file_fsmagic()
3286d7f5d3SJohn Marino				(handles statbuf modes for DEV)
3386d7f5d3SJohn Marino			(handles statbuf modes for executable &c.
3486d7f5d3SJohn Marino			reads data from file.
3586d7f5d3SJohn Marinofuncs.c:		file_buffer()
3686d7f5d3SJohn Marinocompress.c			file_zmagic()
3786d7f5d3SJohn Marinois_tar.c			file_is_tar()
3886d7f5d3SJohn Marinosoftmagic.c			file_softmagic()
3986d7f5d3SJohn Marino						match() - looks for match against main magic database
4086d7f5d3SJohn Marinoascmagic.c			file_ascmagic()
4186d7f5d3SJohn Marinoreadelf.c		file_tryelf()
4286d7f5d3SJohn Marino				"unknown"
4386d7f5d3SJohn Marino
4486d7f5d3SJohn MarinoChristos Zoulas (see README for email address)
45