UnTGZ plug-in - Revision history

Bugmenot: /* Example usage */ checking $0 is wrong ($R0 instead), see Talk:UnTGZ_plug-in#Wrong_example_in_doc

2016-01-26T15:24:14Z

Example usage: checking $0 is wrong ($R0 instead), see Talk:UnTGZ_plug-in#Wrong_example_in_doc

â† Older revision		Revision as of 15:24, 26 January 2016
Line 68:		Line 68:
	<highlight-nsis>; Unzip $TEMP\$FILENAME into installation directory		<highlight-nsis>; Unzip $TEMP\$FILENAME into installation directory
	untgz::extract "-j" "-d" "$INSTDIR" "$TEMP\$FILENAME"		untgz::extract "-j" "-d" "$INSTDIR" "$TEMP\$FILENAME"
	StrCmp $0 "success" +4		StrCmp $R0 "success" +4
	DetailPrint " Failed to extract ${DICT_FILENAME}"		DetailPrint " Failed to extract ${DICT_FILENAME}"
	MessageBox MB_OK\|MB_ICONEXCLAMATION\|MB_DEFBUTTON1 " Failed to extract $FILENAME"		MessageBox MB_OK\|MB_ICONEXCLAMATION\|MB_DEFBUTTON1 " Failed to extract $FILENAME"

Bugmenot: /* Example usage */

2014-08-06T23:10:57Z

Example usage

â† Older revision		Revision as of 23:10, 6 August 2014
Line 68:		Line 68:
	<highlight-nsis>; Unzip $TEMP\$FILENAME into installation directory		<highlight-nsis>; Unzip $TEMP\$FILENAME into installation directory
	untgz::extract "-j" "-d" "$INSTDIR" "$TEMP\$FILENAME"		untgz::extract "-j" "-d" "$INSTDIR" "$TEMP\$FILENAME"
	StrCmp $0 "success" +3		StrCmp $0 "success" +4
	DetailPrint " Failed to extract ${DICT_FILENAME}"		DetailPrint " Failed to extract ${DICT_FILENAME}"
	MessageBox MB_OK\|MB_ICONEXCLAMATION\|MB_DEFBUTTON1 " Failed to extract $FILENAME"		MessageBox MB_OK\|MB_ICONEXCLAMATION\|MB_DEFBUTTON1 " Failed to extract $FILENAME"
			Abort

	; Delete temporary files		; Delete temporary files
	Delete "$TEMP\$FILENAME"		Delete "$TEMP\$FILENAME"

Bugmenot: /* Example usage */ corrected example to a more general one

2014-08-06T21:58:45Z

Example usage: corrected example to a more general one

â† Older revision		Revision as of 21:58, 6 August 2014
Line 66:		Line 66:
	== Example usage ==		== Example usage ==
	This is a snippet from [[AbiWord]]'s NSIS2 script ([http://svn.abisource.com/abiword-msvc2008/trunk/Setup/NSISv2/abi_dict_misc.nsh abi_dict_misc.nsh]):		This is a snippet from [[AbiWord]]'s NSIS2 script ([http://svn.abisource.com/abiword-msvc2008/trunk/Setup/NSISv2/abi_dict_misc.nsh abi_dict_misc.nsh]):
	<highlight-nsis>~~doDictInst:~~		<highlight-nsis>; Unzip $TEMP\$FILENAME into installation directory
	; Unzip ~~dictionary~~ into ~~dictionary subdirectory~~		untgz::extract "-j" "-d" "$INSTDIR" "$TEMP\$FILENAME"
	untgz::extract "-j" "-d" "$INSTDIR~~\dictionary~~" "$TEMP\${DICT_FILENAME}"		StrCmp $0 "success" +3
			DetailPrint " Failed to extract ${DICT_FILENAME}"
			MessageBox MB_OK\|MB_ICONEXCLAMATION\|MB_DEFBUTTON1 " Failed to extract $FILENAME"

	; Delete temporary files		; Delete temporary files
	Delete "$TEMP\$~~{DICT_FILENAME}~~"		Delete "$TEMP\$FILENAME"

	~~Finish:~~
	</highlight-nsis>		</highlight-nsis>

Bugmenot: /* Example usage */ indent and direct link to the source script

2014-08-06T21:45:53Z

Example usage: indent and direct link to the source script

â† Older revision		Revision as of 21:45, 6 August 2014
Line 65:		Line 65:

	== Example usage ==		== Example usage ==
	This is a snippet from [[AbiWord]]'s NSIS2 script:		This is a snippet from [[AbiWord]]'s NSIS2 script ([http://svn.abisource.com/abiword-msvc2008/trunk/Setup/NSISv2/abi_dict_misc.nsh abi_dict_misc.nsh]):
	<highlight-nsis> doDictInst:		<highlight-nsis>doDictInst:
	; Unzip dictionary into dictionary subdirectory		; Unzip dictionary into dictionary subdirectory
	untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"		untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

	; Delete temporary files		; Delete temporary files
	Delete "$TEMP\${DICT_FILENAME}"		Delete "$TEMP\${DICT_FILENAME}"

	Finish:		Finish:
	</highlight-nsis>		</highlight-nsis>

PerditionC: update to 1.0.18

2010-01-16T21:24:09Z

update to 1.0.18

â† Older revision		Revision as of 21:24, 16 January 2010
Line 4:		Line 4:
	Download:<br>		Download:<br>
	<attach>Untgz.zip</attach><br>		<attach>Untgz.zip</attach><br>
	[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (~~259~~ KB) (Mirror #1)<br>		[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.18.zip Untgz.1.0.18.zip] (261 KB) (Mirror #1)<br>
	<br>		<br>
	<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL<br>		<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL<br>
Line 12:		Line 12:

	== Description ==		== Description ==
	'''Version:''' 1.0.17		'''Version:''' 1.0.18

	UnTGZ plugin is similar to ExtractDLL and ZipDLL plugins, except it allows one to extract the files from a tarball. Only simple tarballs are supported, those with filenames longer than 100 characters or including special files may not be supported well (please send me information including where to obtain a sample tarball if better support is required for one of these).<br>		UnTGZ plugin is similar to ExtractDLL and ZipDLL plugins, except it allows one to extract the files from a tarball. Only simple tarballs are supported, those with filenames longer than 100 characters or including special files may not be supported well (please send me information including where to obtain a sample tarball if better support is required for one of these).<br>
	''(Basic support for longer than 100 char filenames added to 1.0.16, but does not yet support unicode or all methods of using long names.)''<br>		''(Basic support for longer than 100 char filenames added to 1.0.16, but does not yet support unicode or all methods of using long names.)'' Limited support for hard links.<br>

	Supports TAR files with no compression (.tar), gzipped [zlib compatible] compression (.tgz / .tar.gz), lzma compression (.tlz / .tar.lzma), and bzip2 compression (.tbz / *.tar.bz2).<br>		Supports TAR files with no compression (.tar), gzipped [zlib compatible] compression (.tgz / .tar.gz), lzma compression (.tlz / .tar.lzma), and bzip2 compression (.tbz / *.tar.bz2).<br>
Line 22:		Line 22:

	== Usage ==		== Usage ==
	; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz		; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-h''] [''-k''] [''-z<type>''] tarball.tgz
	: extracts all files from tarball.tgz		: extracts all files from tarball.tgz
	: if -j is specified then ignore paths in tarball (junkpaths)		: if -j is specified then ignore paths in tarball (junkpaths)
	: if -d is specified will extract relative to basedir		: if -d is specified will extract relative to basedir
			: if -h is specified will return error if fails to create hard link
	: if -k is specified will not overwrite existing files (keep)		: if -k is specified will not overwrite existing files (keep)
	: if -u is specified will only overwrite nonexisting or older files (update)		: if -u is specified will only overwrite nonexisting or older files (update)
	: if -z is specified determines compression used, see below		: if -z is specified determines compression used, see below

	; '''untgz<nowiki>::</nowiki>extractV''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz [''-i {iList}''] [''-x {xList}''] '''--'''		; '''untgz<nowiki>::</nowiki>extractV''' [''-j''] [''-d basedir''] [''-h''] [''-k''] [''-z<type>''] tarball.tgz [''-i {iList}''] [''-x {xList}''] '''--'''
	: extracts files from tarball.tgz		: extracts files from tarball.tgz
	: if -j is specified then ignore paths in tarball (junkpaths)		: if -j is specified then ignore paths in tarball (junkpaths)
	: if -d is specified will extract relative to basedir		: if -d is specified will extract relative to basedir
			: if -h is specified will return error if fails to create hard link
	: if -k is specified will not overwrite existing files (keep)		: if -k is specified will not overwrite existing files (keep)
	: if -u is specified will only overwrite nonexisting or older files (update)		: if -u is specified will only overwrite nonexisting or older files (update)
Line 43:		Line 45:
	; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file		; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
	: extracts just the file specified		: extracts just the file specified
	: path information is ignored, implictly -j is specified (may also be explicit)		: path information is ignored, implictly -j and -h are specified (may also be explicit)


Line 60:		Line 62:

	;NOTES:		;NOTES:
	Without -j there is a security issue as no checking is done to paths, allowing untrusted tarballs to overwrite arbitrary files (e.g. /bin/*). Also no checking is done to directory or file names. In untar.c there is a hook so custom versions can modify/strip filepaths prior to opening. The -d option is currently implemented by a chdir to ~~indicatd~~ directory prior to extraction; future versions may instead prepend to extracted path.		Without -j there is a security issue as no checking is done to paths, allowing untrusted tarballs to overwrite arbitrary files (e.g. /bin/*). Also no checking is done to directory or file names. In untar.c there is a hook so custom versions can modify/strip filepaths prior to opening. The -d option is currently implemented by a chdir to indicated directory prior to extraction; future versions may instead prepend to extracted path.

	== Example usage ==		== Example usage ==
Line 78:		Line 80:

	Based on ExDLL/ExDLL.h and Zlib's untgz, all dependencies included, simply extract to your contrib directory and build with MSVC 6 (or later) or copy included untgz.dll to the plugins subdirectory of your NSIS installation.		Based on ExDLL/ExDLL.h and Zlib's untgz, all dependencies included, simply extract to your contrib directory and build with MSVC 6 (or later) or copy included untgz.dll to the plugins subdirectory of your NSIS installation.
	Some parts (such as extraction with paths) not as well tested.		Some parts (such as extraction with paths, hard links, long names) not as well tested.
	See included README.TXT for more details.		See included README.TXT for more details.

	~~Note: 1.0.9 version fixes problems extracting files from some valid tarballs (updated zlib),~~
	~~which while tested, some issues may still exist that I haven't seen;~~
	~~please test (see also [[Plugin Tester (or Wrapper)\|Plugin Tester]]) your tarballs with it and report to~~
	~~me should any problems occur. Thanks.~~

	As of version 1.0.10, untgz plugin supports lzma compressed TAR files (adds about 5KB to plugin size, so can optionally be compiled out). Create a normal uncompressed tar file (*.tar), then instead of gzipping (or bzipping/compress'ing) use lzma from LZMA SDK (http://www.7zip.org/sdk.html). E.g. 'lzma e myarchive.tar myarchive.tlz'

	~~Version 1.0.11 adds support for compiling with MSVC 8 (Express 2005 + SDK). Unless you wish to recompile with VC8 there no need to update from 1.0.10~~

	Version 1.0.12 finally implements -k keep option, also adds -u update option (same as keep, but will overwrite a file if older than one in archive), and now aborts extraction with error when it fails to extract a file (such as file readonly or open -- previously is just silently skipped the file and returned success).

	Version 1.0.13 integrated BZip2 (v1.0.3) support using miniclib (this version now supports none, gzip, bzip2, or lzma compressed TAR files). Updated to lzma sdk 4.43. (Note: missing call to FindClose(h); when -u is used and file not overwritten.)

	~~Version 1.0.14 fix minor resource leak, missing FindClose call if -u and file skipped. Releases now built with VC8 (MS VC Express 2005 + MS Windows Platform SDK) (prior releases built with MSVC6).~~

	Version 1.0.15 automatically determine compression type if not explicity indicated.		Version 1.0.15 automatically determine compression type if not explicity indicated.
Line 101:		Line 88:

	Version 1.0.17 adds support for Unicode NSIS; does NOT yet support Unicode file names. No functional changes from 1.0.16 for standard NSIS.		Version 1.0.17 adds support for Unicode NSIS; does NOT yet support Unicode file names. No functional changes from 1.0.16 for standard NSIS.

			Version 1.0.18 has initial support for hard links. Will issue a warning if a hard link is found and unable to create. The option -h may be used to force failure if unable to create a hard link. Only works on NT5 or higher on NTFS; will fail to create hard link on all earlier versions of Windows, if file system is FAT or non NTFS, or if accessing NTFS file system via a share (mapped drive).


	[[Category:Plugins]]		[[Category:Plugins]]
	[[Category:Compression]]		[[Category:Compression]]

PerditionC: /* Links */ updated to 1.0.17 - supports Unicode NSIS

2010-01-15T16:54:49Z

Links: updated to 1.0.17 - supports Unicode NSIS

â† Older revision		Revision as of 16:54, 15 January 2010
Line 4:		Line 4:
	Download:<br>		Download:<br>
	<attach>Untgz.zip</attach><br>		<attach>Untgz.zip</attach><br>
	[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (~~260~~ KB) (Mirror #1)<br>		[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (259 KB) (Mirror #1)<br>
	<br>		<br>
	<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL<br>		<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL<br>

PerditionC: /* Notes */

2010-01-15T16:42:07Z

Notes

â† Older revision		Revision as of 16:42, 15 January 2010
Line 100:		Line 100:
	Version 1.0.16 is an update to 1.0.15 that supports the prefix in the tar header for file names longer than 100 characters. Compiled with MSVC6.		Version 1.0.16 is an update to 1.0.15 that supports the prefix in the tar header for file names longer than 100 characters. Compiled with MSVC6.

			Version 1.0.17 adds support for Unicode NSIS; does NOT yet support Unicode file names. No functional changes from 1.0.16 for standard NSIS.

	[[Category:Plugins]]		[[Category:Plugins]]
	[[Category:Compression]]		[[Category:Compression]]

PerditionC: /* Description */

2010-01-15T16:36:20Z

Description

â† Older revision		Revision as of 16:36, 15 January 2010
Line 12:		Line 12:

	== Description ==		== Description ==
	'''Version:''' 1.0.15		'''Version:''' 1.0.17

	UnTGZ plugin is similar to ExtractDLL and ZipDLL plugins, except it allows one to extract the files from a tarball. Only simple tarballs are supported, those with filenames longer than 100 characters or including special files may not be supported well (please send me information including where to obtain a sample tarball if better support is required for one of these).<br>		UnTGZ plugin is similar to ExtractDLL and ZipDLL plugins, except it allows one to extract the files from a tarball. Only simple tarballs are supported, those with filenames longer than 100 characters or including special files may not be supported well (please send me information including where to obtain a sample tarball if better support is required for one of these).<br>

PerditionC: /* Links */

2010-01-15T16:35:07Z

Links

â† Older revision		Revision as of 16:35, 15 January 2010
Line 4:		Line 4:
	Download:<br>		Download:<br>
	<attach>Untgz.zip</attach><br>		<attach>Untgz.zip</attach><br>
	[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.15.zip Untgz.1.0.15.zip] (~~225~~ KB) (Mirror #1)<br>		[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (260 KB) (Mirror #1)<br>
	<br>		<br>
	~~[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.16.zip Untgz.1.0.16.zip] (34 KB) update to 1.0.15 with improved support for tar files with names longer than 100 characters<br>~~
	<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL<br>		<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL<br>
	[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.10.zip Untgz.1.0.10.zip] (158 KB) Older Untgz plugin with only gzip & LZMA support<br>		[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.10.zip Untgz.1.0.10.zip] (158 KB) Older Untgz plugin with only gzip & LZMA support<br>

63.167.255.153: /* Description */

2010-01-09T19:12:31Z

Description

â† Older revision		Revision as of 19:12, 9 January 2010
Line 16:		Line 16:

	UnTGZ plugin is similar to ExtractDLL and ZipDLL plugins, except it allows one to extract the files from a tarball. Only simple tarballs are supported, those with filenames longer than 100 characters or including special files may not be supported well (please send me information including where to obtain a sample tarball if better support is required for one of these).<br>		UnTGZ plugin is similar to ExtractDLL and ZipDLL plugins, except it allows one to extract the files from a tarball. Only simple tarballs are supported, those with filenames longer than 100 characters or including special files may not be supported well (please send me information including where to obtain a sample tarball if better support is required for one of these).<br>
			''(Basic support for longer than 100 char filenames added to 1.0.16, but does not yet support unicode or all methods of using long names.)''<br>

	Supports TAR files with no compression (.tar), gzipped [zlib compatible] compression (.tgz / .tar.gz), lzma compression (.tlz / .tar.lzma), and bzip2 compression (.tbz / *.tar.bz2).<br>		Supports TAR files with no compression (.tar), gzipped [zlib compatible] compression (.tgz / .tar.gz), lzma compression (.tlz / .tar.lzma), and bzip2 compression (.tbz / *.tar.bz2).<br>