NSIS Wiki - User contributions [en]

DialogsEx plug-in

2010-02-23T15:08:41Z

PerditionC: /* Links */ Unicode NSIS compatible version (and mirror)

{{PageAuthor|Joel}}

== Links ==
[http://nsis.sourceforge.net/Joel_plugin_src Main]

[http://www.fdos.org/win32/nsis/plugins/others/joel/ mirror] DialogsEx for NSIS & Unicode NSIS

== Description ==

'''Version:''' 1.0.

This plug-in is an extension for the [[Dialogs plug-in]] by the same author which has more options than the previous version of the plug-in. It contains 7 types of dialog boxes:

* Open file dialog box.
* Save file dialog box.
* Classic folder browse dialog box.
* Modern folder browse dialog box.
* InputTextBox (only for text).
* InputPwdBox (text + password).
* InputRegBox (User with serial).

MoreInfo plug-in

2010-02-18T08:11:06Z

PerditionC: /* OS User Language Information DLL Function */ update to match source/tested behaviour

{{PageAuthor|onad}}

== Links ==

<attach>MoreInfo.zip</attach> (w/ Delphi source)

[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/others/MoreInfo.1.0.1.2.zip MoreInfo.1.0.1.2.zip] (35KB) (NSIS & Unicode NSIS versions, translated into C source)

[http://forums.winamp.com/showthread.php?postid=1692707#post1692707 MoreInfo Forums Thread]

== Description ==

This plugin correctly retrieves version information from files and the Windows OS user interface language.

This is a better inplementation than [[FileInfo plugin]], with more accurate results.

== Usage ==

=== File Information DLL Functions ===

==== Default File Properties ====

<highlight-nsis>MoreInfo::Get<File Property> <Filename></highlight-nsis>

These functions return the values of default file properties to the stack.

;<File Property>
:One of the default file properties from the list below: (ie: ProductName)
:*Comments
:*PrivateBuild
:*SpecialBuild
:*ProductName
:*ProductVersion
:*CompanyName
:*FileVersion
:*FileDescription
:*LegalCopyright
:*LegalTrademarks
:*OriginalFileName

;<Filename>
:Valid filename where the information is taken from. (ie: "C:\Windows\MyFile.dll")

==== User Defined File Properties ====

<highlight-nsis>MoreInfo::GetUserDefined <Filename> <PropertyName></highlight-nsis>

This function returns an user defined file property value to the stack.

;<Filename>
:Valid filename where the information is taken from. (ie: "C:\Windows\MyFile.dll")

;<PropertyName>
:Valid name of an user defined property you want to obtain a value from. (ie: "Language")

;<Variable>
:The variable where to output the return value. (ie: "$0")

=== OS User Language Information DLL Function ===

<highlight-nsis>MoreInfo::GetOSUserinterfaceLanguage</highlight-nsis>

This function sets $LANGUAGE to the user interface language; it does not push any value to the stack.

=== Return Value Syntax ===

*If the property was found: its value will be returned (ie: "My Company");
*If the property was not found: it will be "";
*Otherwise, the value returned will start with "Error:", followed by an error message (ie: "Error:Unable to allocate memory.").

== How the language will be determined ==

When the installer starts up it goes through these steps to select the interface language:

#Get user's default Windows OS GUI language;
#Find a perfect match for the language;
#If there is no perfect match, find a primary language match;
#If there is no match, use the first language defined in the script (make sure your first language is a common one like English);
#If the langauge variable $LANGUAGE has changed during .onInit, NSIS goes through steps 2 to 4 again, as in the case of this plugin.

As you can see the outcome of a chosen language is never un-expected.

== Examples ==

There are two examples inside the .zip file.

1) SimpleDemo
Shows of the basic functionality of MoreInfo

2) CustomLanguageDemo
Fully shows the power of getting the OS GUI language. I the demo a good example of how custompage localization works and could be implemented.

== Info about LCID's ==

The LCID, or "locale identifer," is a 32-bit data type into which are packed several different values that help to identify a particular geographical region. One of these internal values is the "primary language ID" which identifies the basic language of the region or locale, such as English, Spanish, or Turkish.

For conversion from LCID to NSIS Language define we use the following table. The table lists some common LCIDs as well as well as some less common ones that are valid for NSIS even through Windows does not recognize them by default. Note that this is this probably not a complete list of all possible LCIDs. Feel free to improve
the list below.

Some Valid LCIDs. (Note: $ in front means the value is in Hexidecimal notation)

{|
| Afrikaans || $0436
|-
| Albanian || $041c
|-
| Arabic (Algeria) || $1401
|-
| Arabic (Bahrain) || $3c01
|-
| Arabic (Egypt) || $0c01
|-
| Arabic (Iraq) || $0801
|-
| Arabic (Jordan) || $2c01
|-
| Arabic (Kuwait) || $3401
|-
| Arabic (Lebanon) || $3001
|-
| Arabic (Libya) || $1001
|-
| Arabic (Morocco) || $1801
|-
| Arabic (Oman) || $2001
|-
| Arabic (Qatar) || $4001
|-
| Arabic (Saudi Arabia) || $0401
|-
| Arabic (Syria) || $2801
|-
| Arabic (Tunisia) || $1c01
|-
| Arabic (U.A.E.) || $3801
|-
| Arabic (Yemen) || $2401
|-
| Basque || $042d
|-
| Belarusian || $0423
|-
| Bulgarian || $0402
|-
| Catalan || $0403
|-
| Chinese (Hong Kong SAR) || $0c04
|-
| Chinese (PRC) || $0804
|-
| Chinese (Singapore) || $1004
|-
| Chinese (Taiwan) || $0404
|-
| Croatian || $041a
|-
| Czech || $0405
|-
| Danish || $0406
|-
| Dutch (Belgian) || $0813
|-
| Dutch (Standard) || $0413
|-
| English (Australian) || $0c09
|-
| English (Belize) || $2809
|-
| English (Canadian) || $1009
|-
| English (Caribbean) || $2409
|-
| English (Ireland) || $1809
|-
| English (Jamaica) || $2009
|-
| English (New Zealand) || $1409
|-
| English (South Africa) || $1c09
|-
| English (Trinidad) || $2c09
|-
| English (United Kingdom) || $0809
|-
| English (United States) || $0409
|-
| Estonian || $0425
|-
| Faeroese || $0438
|-
| Farsi || $0429
|-
| Finnish || $040b
|-
| French (Belgian) || $080c
|-
| French (Canadian) || $0c0c
|-
| French (Luxembourg) || $140c
|-
| French (Standard) || $040c
|-
| French (Swiss) || $100c
|-
| German (Austrian) || $0c07
|-
| German (Liechtenstein) || $1407
|-
| German (Luxembourg) || $1007
|-
| German (Standard) || $0407
|-
| German (Swiss) || $0807
|-
| Greek || $0408
|-
| Hebrew || $040d
|-
| Hungarian || $040e
|-
| Icelandic || $040f
|-
| Indonesian || $0421
|-
| Italian (Standard) || $0410
|-
| Italian (Swiss) || $0810
|-
| Japanese || $0411
|-
| Korean || $0412
|-
| Korean (Johab) || $0812
|-
| Latvian || $0426
|-
| Lithuanian || $0427
|-
| Malay (Malaysian) || $043e
|-
| Malay (Brunei) || $083e
|-
| Norwegian (Bokmal) || $0414
|-
| Norwegian (Nynorsk) || $0814
|-
| Polish || $0415
|-
| Portuguese (Brazil) || $0416
|-
| Portuguese (Portugal) || $0816
|-
| Romanian || $0418
|-
| Russian || $0419
|-
| Serbian (Cyrillic) || $0c1a
|-
| Serbian (Latin) || $081a
|-
| Slovak || $041b
|-
| Slovenian || $0424
|-
| Spanish (Argentina) || $2c0a
|-
| Spanish (Bolivia) || $400a
|-
| Spanish (Chile) || $340a
|-
| Spanish (Colombia) || $240a
|-
| Spanish (Costa Rica) || $140a
|-
| Spanish (Dominican Republic) || $1c0a
|-
| Spanish (Ecuador) || $300a
|-
| Spanish (El Salvador) || $440a
|-
| Spanish (Guatemala) || $100a
|-
| Spanish (Honduras) || $480a
|-
| Spanish (Mexican) || $080a
|-
| Spanish (Modern Sort) || $0c0a
|-
| Spanish (Nicaragua) || $4c0a
|-
| Spanish (Panama) || $180a
|-
| Spanish (Paraguay) || $3c0a
|-
| Spanish (Peru) || $280a
|-
| Spanish (Puerto Rico) || $500a
|-
| Spanish (Traditional Sort) || $040a
|-
| Spanish (Uruguay) || $380a
|-
| Spanish (Venezuela) || $200a
|-
| Swahili || $0441
|-
| Swedish || $041d
|-
| Swedish (Finland) || $081d
|-
| Thai || $041e
|-
| Turkish || $041f
|-
| Ukrainian || $0422
|}

Several CD/DVD methods and properties return locale identifier (LCID) values that identify which languages are available on the soundtracks or subtitles. To make use of this information, your application will need to extract the primary language ID from the returned LCID. To do this,
perform a bitwise AND operation on the value of iLCID and $3FF. (The primary language ID is contained in the least significant 10 bits of the LCID.) The following code snippet shows how to do this.

<highlight-delphi>iPrimaryLang = iLCID & $3FF;</highlight-delphi>

To obtain an human-readable string from the primary language ID, call GetLangFromLangID as shown in this example:

<highlight-delphi>sLanguage = DVD.GetLangFromLangID(iPrimaryLang);</highlight-delphi>

See the Microsoftï¿½ Platform SDK for more information on LCIDs and language identifiers. The following list shows the primary language IDs for the LCIDs in the table above.

Some Valid Primary Language IDs:

{|
| Afrikaans || $36
|-
| Albanian || $1c
|-
| Arabic || $01
|-
| Basque || $2d
|-
| Belarusian || $23
|-
| Bulgarian || $02
|-
| Catalan || $03
|-
| Chinese || $04
|-
| Croatian || $1a
|-
| Czech || $05
|-
| Danish || $06
|-
| Dutch || $13
|-
| English || $09
|-
| Estonian || $25
|-
| Faeroese || $38
|-
| Farsi || $29
|-
| Finnish || $0b
|-
| French || $0c
|-
| German || $07
|-
| Greek || $08
|-
| Hebrew || $0d
|-
| Hungarian || $0e
|-
| Icelandic || $0f
|-
| Indonesian || $21
|-
| Italian || $10
|-
| Japanese || $11
|-
| Korean || $12
|-
| Latvian || $26
|-
| Lithuanian || $27
|-
| Malay || $3e
|-
| Norwegian || $14
|-
| Polish || $15
|-
| Portuguese || $16
|-
| Romanian || $18
|-
| Russian || $19
|-
| Serbian || $1a
|-
| Slovak || $1b
|-
| Slovenian || $24
|-
| Spanish || $0a
|-
| Swahili || $41
|-
| Swedish || $1d
|-
| Thai || $1e
|-
| Turkish || $1f
|-
| Ukrainian || $22
|}

== Source ==

Freeware, can be used anywhere by anyone, or whatever license Nullsoft has bound their wrapper with, most of the rest came from the top of my head. See the source for possible more information.

Built with Borland Delphi v7.1.1 
http://www.borland.com/delphi/

Success with building customer friendly installations!

E. Onad

[[Category:Plugins]]

MoreInfo plug-in

2010-02-18T08:07:12Z

PerditionC: /* Links */ Unicode NSIS version

{{PageAuthor|onad}}

== Links ==

<attach>MoreInfo.zip</attach> (w/ Delphi source)

[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/others/MoreInfo.1.0.1.2.zip MoreInfo.1.0.1.2.zip] (35KB) (NSIS & Unicode NSIS versions, translated into C source)

[http://forums.winamp.com/showthread.php?postid=1692707#post1692707 MoreInfo Forums Thread]

== Description ==

This plugin correctly retrieves version information from files and the Windows OS user interface language.

This is a better inplementation than [[FileInfo plugin]], with more accurate results.

== Usage ==

=== File Information DLL Functions ===

==== Default File Properties ====

<highlight-nsis>MoreInfo::Get<File Property> <Filename></highlight-nsis>

These functions return the values of default file properties to the stack.

;<File Property>
:One of the default file properties from the list below: (ie: ProductName)
:*Comments
:*PrivateBuild
:*SpecialBuild
:*ProductName
:*ProductVersion
:*CompanyName
:*FileVersion
:*FileDescription
:*LegalCopyright
:*LegalTrademarks
:*OriginalFileName

;<Filename>
:Valid filename where the information is taken from. (ie: "C:\Windows\MyFile.dll")

==== User Defined File Properties ====

<highlight-nsis>MoreInfo::GetUserDefined <Filename> <PropertyName></highlight-nsis>

This function returns an user defined file property value to the stack.

;<Filename>
:Valid filename where the information is taken from. (ie: "C:\Windows\MyFile.dll")

;<PropertyName>
:Valid name of an user defined property you want to obtain a value from. (ie: "Language")

;<Variable>
:The variable where to output the return value. (ie: "$0")

=== OS User Language Information DLL Function ===

<highlight-nsis>MoreInfo::GetOSUserinterfaceLanguage</highlight-nsis>

This function retrives the user interface language to the stack.

;<Variable>
:The variable where to output the return value. (ie: "$0")

=== Return Value Syntax ===

*If the property was found: its value will be returned (ie: "My Company");
*If the property was not found: it will be "";
*Otherwise, the value returned will start with "Error:", followed by an error message (ie: "Error:Unable to allocate memory.").

== How the language will be determined ==

When the installer starts up it goes through these steps to select the interface language:

#Get user's default Windows OS GUI language;
#Find a perfect match for the language;
#If there is no perfect match, find a primary language match;
#If there is no match, use the first language defined in the script (make sure your first language is a common one like English);
#If the langauge variable $LANGUAGE has changed during .onInit, NSIS goes through steps 2 to 4 again, as in the case of this plugin.

As you can see the outcome of a chosen language is never un-expected.

== Examples ==

There are two examples inside the .zip file.

1) SimpleDemo
Shows of the basic functionality of MoreInfo

2) CustomLanguageDemo
Fully shows the power of getting the OS GUI language. I the demo a good example of how custompage localization works and could be implemented.

== Info about LCID's ==

The LCID, or "locale identifer," is a 32-bit data type into which are packed several different values that help to identify a particular geographical region. One of these internal values is the "primary language ID" which identifies the basic language of the region or locale, such as English, Spanish, or Turkish.

For conversion from LCID to NSIS Language define we use the following table. The table lists some common LCIDs as well as well as some less common ones that are valid for NSIS even through Windows does not recognize them by default. Note that this is this probably not a complete list of all possible LCIDs. Feel free to improve
the list below.

Some Valid LCIDs. (Note: $ in front means the value is in Hexidecimal notation)

{|
| Afrikaans || $0436
|-
| Albanian || $041c
|-
| Arabic (Algeria) || $1401
|-
| Arabic (Bahrain) || $3c01
|-
| Arabic (Egypt) || $0c01
|-
| Arabic (Iraq) || $0801
|-
| Arabic (Jordan) || $2c01
|-
| Arabic (Kuwait) || $3401
|-
| Arabic (Lebanon) || $3001
|-
| Arabic (Libya) || $1001
|-
| Arabic (Morocco) || $1801
|-
| Arabic (Oman) || $2001
|-
| Arabic (Qatar) || $4001
|-
| Arabic (Saudi Arabia) || $0401
|-
| Arabic (Syria) || $2801
|-
| Arabic (Tunisia) || $1c01
|-
| Arabic (U.A.E.) || $3801
|-
| Arabic (Yemen) || $2401
|-
| Basque || $042d
|-
| Belarusian || $0423
|-
| Bulgarian || $0402
|-
| Catalan || $0403
|-
| Chinese (Hong Kong SAR) || $0c04
|-
| Chinese (PRC) || $0804
|-
| Chinese (Singapore) || $1004
|-
| Chinese (Taiwan) || $0404
|-
| Croatian || $041a
|-
| Czech || $0405
|-
| Danish || $0406
|-
| Dutch (Belgian) || $0813
|-
| Dutch (Standard) || $0413
|-
| English (Australian) || $0c09
|-
| English (Belize) || $2809
|-
| English (Canadian) || $1009
|-
| English (Caribbean) || $2409
|-
| English (Ireland) || $1809
|-
| English (Jamaica) || $2009
|-
| English (New Zealand) || $1409
|-
| English (South Africa) || $1c09
|-
| English (Trinidad) || $2c09
|-
| English (United Kingdom) || $0809
|-
| English (United States) || $0409
|-
| Estonian || $0425
|-
| Faeroese || $0438
|-
| Farsi || $0429
|-
| Finnish || $040b
|-
| French (Belgian) || $080c
|-
| French (Canadian) || $0c0c
|-
| French (Luxembourg) || $140c
|-
| French (Standard) || $040c
|-
| French (Swiss) || $100c
|-
| German (Austrian) || $0c07
|-
| German (Liechtenstein) || $1407
|-
| German (Luxembourg) || $1007
|-
| German (Standard) || $0407
|-
| German (Swiss) || $0807
|-
| Greek || $0408
|-
| Hebrew || $040d
|-
| Hungarian || $040e
|-
| Icelandic || $040f
|-
| Indonesian || $0421
|-
| Italian (Standard) || $0410
|-
| Italian (Swiss) || $0810
|-
| Japanese || $0411
|-
| Korean || $0412
|-
| Korean (Johab) || $0812
|-
| Latvian || $0426
|-
| Lithuanian || $0427
|-
| Malay (Malaysian) || $043e
|-
| Malay (Brunei) || $083e
|-
| Norwegian (Bokmal) || $0414
|-
| Norwegian (Nynorsk) || $0814
|-
| Polish || $0415
|-
| Portuguese (Brazil) || $0416
|-
| Portuguese (Portugal) || $0816
|-
| Romanian || $0418
|-
| Russian || $0419
|-
| Serbian (Cyrillic) || $0c1a
|-
| Serbian (Latin) || $081a
|-
| Slovak || $041b
|-
| Slovenian || $0424
|-
| Spanish (Argentina) || $2c0a
|-
| Spanish (Bolivia) || $400a
|-
| Spanish (Chile) || $340a
|-
| Spanish (Colombia) || $240a
|-
| Spanish (Costa Rica) || $140a
|-
| Spanish (Dominican Republic) || $1c0a
|-
| Spanish (Ecuador) || $300a
|-
| Spanish (El Salvador) || $440a
|-
| Spanish (Guatemala) || $100a
|-
| Spanish (Honduras) || $480a
|-
| Spanish (Mexican) || $080a
|-
| Spanish (Modern Sort) || $0c0a
|-
| Spanish (Nicaragua) || $4c0a
|-
| Spanish (Panama) || $180a
|-
| Spanish (Paraguay) || $3c0a
|-
| Spanish (Peru) || $280a
|-
| Spanish (Puerto Rico) || $500a
|-
| Spanish (Traditional Sort) || $040a
|-
| Spanish (Uruguay) || $380a
|-
| Spanish (Venezuela) || $200a
|-
| Swahili || $0441
|-
| Swedish || $041d
|-
| Swedish (Finland) || $081d
|-
| Thai || $041e
|-
| Turkish || $041f
|-
| Ukrainian || $0422
|}

Several CD/DVD methods and properties return locale identifier (LCID) values that identify which languages are available on the soundtracks or subtitles. To make use of this information, your application will need to extract the primary language ID from the returned LCID. To do this,
perform a bitwise AND operation on the value of iLCID and $3FF. (The primary language ID is contained in the least significant 10 bits of the LCID.) The following code snippet shows how to do this.

<highlight-delphi>iPrimaryLang = iLCID & $3FF;</highlight-delphi>

To obtain an human-readable string from the primary language ID, call GetLangFromLangID as shown in this example:

<highlight-delphi>sLanguage = DVD.GetLangFromLangID(iPrimaryLang);</highlight-delphi>

See the Microsoftï¿½ Platform SDK for more information on LCIDs and language identifiers. The following list shows the primary language IDs for the LCIDs in the table above.

Some Valid Primary Language IDs:

{|
| Afrikaans || $36
|-
| Albanian || $1c
|-
| Arabic || $01
|-
| Basque || $2d
|-
| Belarusian || $23
|-
| Bulgarian || $02
|-
| Catalan || $03
|-
| Chinese || $04
|-
| Croatian || $1a
|-
| Czech || $05
|-
| Danish || $06
|-
| Dutch || $13
|-
| English || $09
|-
| Estonian || $25
|-
| Faeroese || $38
|-
| Farsi || $29
|-
| Finnish || $0b
|-
| French || $0c
|-
| German || $07
|-
| Greek || $08
|-
| Hebrew || $0d
|-
| Hungarian || $0e
|-
| Icelandic || $0f
|-
| Indonesian || $21
|-
| Italian || $10
|-
| Japanese || $11
|-
| Korean || $12
|-
| Latvian || $26
|-
| Lithuanian || $27
|-
| Malay || $3e
|-
| Norwegian || $14
|-
| Polish || $15
|-
| Portuguese || $16
|-
| Romanian || $18
|-
| Russian || $19
|-
| Serbian || $1a
|-
| Slovak || $1b
|-
| Slovenian || $24
|-
| Spanish || $0a
|-
| Swahili || $41
|-
| Swedish || $1d
|-
| Thai || $1e
|-
| Turkish || $1f
|-
| Ukrainian || $22
|}

== Source ==

Freeware, can be used anywhere by anyone, or whatever license Nullsoft has bound their wrapper with, most of the rest came from the top of my head. See the source for possible more information.

Built with Borland Delphi v7.1.1 
http://www.borland.com/delphi/

Success with building customer friendly installations!

E. Onad

[[Category:Plugins]]

AbiWord

2010-02-01T02:57:54Z

PerditionC: /* Links */ updated link

{{PageAuthor|PerditionC}}

== Links ==
See [http://svn.abisource.com/abiword-msvc2008/trunk/Setup/NSISv2/ AbiWord.nsi] at [http://www.abisource.com abisource.com] for the installer used by AbiWord (version 2.x) when using the NSIS 2 branch. It is still a work in progress so I have only posted the link instead of the actual source. The installer requires NSIS version 2.

== Description ==
While I do not claim it is the best example, it does demonstrate the use of the MODERN UI using multilingual capabilities (NOTE: some installer specific translations do not have corresponding NSIS translations), command line parsing support to effect behaviour, several sections and subsections (including initial add/modify/remove support), macros, and the use of several plugins including [[NSISdl]] and [[UnTGZ]]. I have tried to keep each snippet (most from or based on work in these archive pages) within its own file for easier reuse.

The older AbiWord installer based on last NSIS v1 release is also available (AbiWord.nsi one directory down), but it is no longer maintained.

[[Category:Real World Installers]]

Linker plug-in

2010-02-01T00:32:58Z

PerditionC: /* Download */ add Unicode NSIS version

__NOTOC__ {{PageAuthor|kichik}}

==Download==

<attach>Linker.zip</attach> 
 
[http://www.fdos.org/win32/nsis/plugins/others/Linker.1.1.zip Linker.1.1.zip] (25KB) NSIS & Unicode NSIS versions

==Description==

This plug-in transforms a label into a clickable link. It can be used to add links to non-custom pages, such as the license and the components page. Usage is very simple and requires just a HWND.

==Example==

<highlight-nsis>FindWindow $0 "#32770" "" $HWNDPARENT
GetDlgItem $0 $0 1006
Linker::link /NOUNLOAD $0 "http://www.google.com/"</highlight-nsis>

==Credits==

The code responsible for the actual linking was taken from [http://catch22.net/tuts/urlctrl.asp catch22] and was created by James Brown & Ralph Bittmann. This plug-in is nothing but a wrapper for their code.

[[Category:Plugins]]

CRCCheck plug-in

2010-01-28T11:49:28Z

PerditionC: /* Links */ Unicode NSIS compatible version

{{PageAuthor|SpiderVenom}}

== Links ==
<attach>CRCCheck.zip</attach> 
 
[http://www.fdos.org/win32/nsis/plugins/others/CRCCheck.1.4.zip CRCCheck.1.4.zip] NSIS & Unicode NSIS versions

== Description ==
'''Version:''' 1.3.

A small (3KB) plugin that generates a standard ZIP CRC32 for any file you pass it:

== Example ==
<highlight-nsis>
CRCCheck::GenCRC "$SYSDIR\explorer.exe"
Pop $R1
MessageBox MB_OK $R1
</highlight-nsis>This gives you a CRC for the windows explorer executable. If a CRC can not be generated, you get "0" in $R1. Specific error reporting will come soon.

Written in VC++ 7, it reuses the CRC code from VPatch, with a few tweaks.

Just extract CRCCheck.zip to your NSIS dir (with folder names), and everything will go in the right place. Check \Contrib\CRCCheck\Readme.txt for more info.

[[Category:Plugins]]

MD5 plugin

2010-01-23T20:42:40Z

PerditionC: Update to support Unicode NSIS

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Md5dll.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/md5dll/md5dll.0.5.zip Md5dll.0.5.zip] (21 KB) (Mirror #1)

[http://www.fdos.org/win32/nsis/plugins/md5dll/ Older Versions of MD5 plugin]

[http://forums.winamp.com/showthread.php?threadid=117789 Original NSIS Forums Thread (for older versions)]

== Description ==
Generates a [[wikipedia:MD5|md5]] value from either a string or contents of specified file.

Original: MD5 Plugin DLL by Matthew "IGx89" Lieder, derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm

== Sample Usage ==
<highlight-nsis>
OutFile "md5test.exe"
Section ""
#generate MD5sum of string
md5dll::GetMD5String "md5me"
Pop $0
DetailPrint "md5: [$0]"

# generate MD5sum of file
md5dll::GetMD5File "${NSISDIR}\makensis.exe"
Pop $0
DetailPrint "md5: [$0]"

#generate random MD5sum
md5dll::GetMD5Random
Pop $0
DetailPrint "md5: [$0]"
SectionEnd
</highlight-nsis>

== Versions History ==
;0.5
:KJD (2010):
:*Unicode NSIS support: functionally identical to 0.4
:*Warning: passed strings and filenames must still be convertable to current code page (ASCII).
;0.4
:KJD (2005):
:*Added dual name to exports for backwards compatibility.
;0.3
:Shengalts Aleksander aka Instructor (2005):
:*New command: "GetMD5Random".
:*Changed names: "GetFileMD5" -> "GetMD5File", "GetMD5" -> "GetMD5String".
:*Fixed: string length error.
;0.2
:Davy Durham (2004):
:*MD5.cpp fix (correct for loop used to replace memset, exceeded bounds).
;0.1
:KJD (2004):
:*Modified to reduce size and use exdll.h (reduced to about 6KB uncompressed, by removing CRTL dependency).
;Original
:Matthew "IGx89" Lieder:
:*Original plugin Author.
:Sunjammer (12th May 2002):
:*Original usage notes and example script.

[[Category:Plugins]]

File:Md5dll.zip

2010-01-23T20:36:08Z

PerditionC: uploaded a new version of "File:Md5dll.zip": (version 0.5)

UnTGZ plug-in

2010-01-16T21:24:09Z

PerditionC: update to 1.0.18

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.18.zip Untgz.1.0.18.zip] (261 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''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). 
''(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. 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-h''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: 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 -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below

; '''untgz<nowiki>::</nowiki>extractV''' [''-j''] [''-d basedir''] [''-h''] [''-k''] [''-z<type>''] tarball.tgz [''-i {iList}''] [''-x {xList}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: 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 -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j and -h are specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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 indicated directory prior to extraction; future versions may instead prepend to extracted path.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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, hard links, long names) not as well tested.
See included README.TXT for more details.

Version 1.0.15 automatically determine compression type if not explicity indicated.

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.

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:Compression]]

UnTGZ plug-in

2010-01-15T16:54:49Z

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

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (259 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''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). 
''(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.)'' 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.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:Compression]]

File:Untgz.zip

2010-01-15T16:51:48Z

PerditionC: uploaded a new version of "File:Untgz.zip": Update to 1.0.17. Add support for Unicode NSIS.

UnTGZ plug-in

2010-01-15T16:42:07Z

PerditionC: /* Notes */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (260 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''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). 
''(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.)'' 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.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:Compression]]

UnTGZ plug-in

2010-01-15T16:36:20Z

PerditionC: /* Description */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (260 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''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). 
''(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.)'' 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.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.

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

UnTGZ plug-in

2010-01-15T16:35:07Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.17.zip Untgz.1.0.17.zip] (260 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

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

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). 
''(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.)'' 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.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.

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

Talk:UnTGZ plug-in

2007-11-10T17:52:16Z

PerditionC:

My antivirus, Kaspersky thinks this is a trojan. Anyone else getting issues like this?

It should be a false positive; I'm running Norton Antivirus and have a firewall + try to keep Windows patched, so my system is hopefully clean -- the full source is there if you want to compile yourself and verify [the free MS compiler toolkit should work to build it]. Which version? Jeremy

darklogic mirrors appear to be down `[[User:71.163.165.64|71.163.165.64]] 10:11, 12 May 2007 (PDT)
Domain name registration lapsed, now at fdos.org

UnTGZ plug-in

2007-11-10T17:50:15Z

PerditionC: /* Notes */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.15.zip Untgz.1.0.15.zip] (225 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

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

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.

[[Category:Plugins]]

UnTGZ plug-in

2007-11-10T17:44:47Z

PerditionC: /* Description */ ver 1.0.15

UnTGZ plug-in

2007-11-10T17:44:09Z

PerditionC: /* Usage */ update to reflect -z<type> option no longer required

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.15.zip Untgz.1.0.15.zip] (225 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;The -z<type> option may be specified to explicitly indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib,
: -zgz alias for -z
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression
: -zauto determines type based on content & extension this is the default if -z<type> option is omitted '''NOTE:''' prior to version 1.0.15 -z was the default so .tlz & .tbz required -zlzma & -zbz2 respectively if those compression methods used.

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.)

[[Category:Plugins]]

UnTGZ plug-in

2007-11-10T16:34:49Z

PerditionC: /* Links */ update to 1.0.15 version

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.15.zip Untgz.1.0.15.zip] (225 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.)

[[Category:Plugins]]

MD5 plugin

2007-11-03T22:56:43Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Md5dll.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/md5dll/md5dll.0.4.zip Md5dll.0.4.zip] (13 KB) (Mirror #1)

[http://www.fdos.org/win32/nsis/plugins/md5dll/ Older Versions of MD5 plugin]

[http://forums.winamp.com/showthread.php?threadid=117789 Original NSIS Forums Thread (for older versions)]

== Description ==
Generates a [[wikipedia:MD5|md5]] value from either a string or contents of specified file.

Original: MD5 Plugin DLL by Matthew "IGx89" Lieder, derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm

== Sample Usage ==
<highlight-nsis>
OutFile "md5test.exe"
Section ""
#generate MD5sum of string
md5dll::GetMD5String "md5me"
Pop $0
DetailPrint "md5: [$0]"

# generate MD5sum of file
md5dll::GetMD5File "${NSISDIR}\makensis.exe"
Pop $0
DetailPrint "md5: [$0]"

#generate random MD5sum
md5dll::GetMD5Random
Pop $0
DetailPrint "md5: [$0]"
SectionEnd
</highlight-nsis>

== Versions History ==
;0.4
:KJD (2005):
:*Added dual name to exports for backwards compatibility.
;0.3
:Shengalts Aleksander aka Instructor (2005):
:*New command: "GetMD5Random".
:*Changed names: "GetFileMD5" -> "GetMD5File", "GetMD5" -> "GetMD5String".
:*Fixed: string length error.
;0.2
:Davy Durham (2004):
:*MD5.cpp fix (correct for loop used to replace memset, exceeded bounds).
;0.1
:KJD (2004):
:*Modified to reduce size and use exdll.h (reduced to about 6KB uncompressed, by removing CRTL dependency).
;Original
:Matthew "IGx89" Lieder:
:*Original plugin Author.
:Sunjammer (12th May 2002):
:*Original usage notes and example script.

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T20:01:23Z

PerditionC: /* Links */ reflect proper size, maybe refreshed attached info?

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (251 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.)

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T19:59:21Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[File:Untgz.zip|thumb|Description]] 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.)

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T19:46:38Z

PerditionC: /* Notes */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.)

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T19:45:44Z

PerditionC: /* Usage */ update is implemented

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: if -u is specified will only overwrite nonexisting or older files (update)
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T19:31:42Z

PerditionC: /* Notes */ add info about latest version

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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.

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T19:28:04Z

PerditionC: /* Description */ found v1.0.13 so correct version info

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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).

[[Category:Plugins]]

UnTGZ plug-in

2007-11-03T19:27:01Z

PerditionC: /* Links */ update url of mirror (my site)

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.fdos.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 
 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 
[[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 
 
Older releases may be found at http://www.fdos.org/win32/nsis/plugins/. 

== Description ==
'''Version:''' 1.0.10
(Latest is 1.0.13, but I've since lost versions 1.0.12 and 1.0.13)

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). 

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). 

For problems, corrections, etc. send email to PerditionC __at gmail.com (or jeremyd --at-- fdos.org)

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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).

[[Category:Plugins]]

Plugin Tester (or Wrapper)

2006-11-22T18:00:57Z

PerditionC: /* Usage */

{{PageAuthor|PerditionC}}

== Links ==
<attach>PlgnTester.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/plgnTester.0.01.zip PlgnTester.0.01.zip] (30 KB) (Mirror #1)

== Description ==
plgntester - NSIS Plugin Tester v0.01

This is a command line program that can be used to
invoke a NSIS plugin. It supports passing any string
variable on the stack, setting any of the standard
variables (user defined variables are unsupported),
and can invoke any specified function in given plugin.

== Usage ==
plgnTester.exe [options] plugin function {/VAR # str} [args]

Currently the only options available determine the output.
/silent limits output to that displayed by the plugin
/nogui prevents the mock NSIS installation listview dialog
/debug displays the contents of the stack and registers
before and after the plugin function is invoked.

Plugin is the name of the plugin (or dll) to load, passed
asis to LoadLibrary, so one can omit the .dll and normal
path search should be done, but if in the NSIS plugin
directory, you will need to explicitly provide its path.
An error message is returned if failed to load.

Function is the name of the exported function to invoke.
It should be exactly as exported, which should match
the name used in a NSIS script. An error message is
returned if function is not found or other error obtaining
its procedure address.

Any number (as permitted by the command line) of /VAR # str
sequences can be included (and in any location on cmd line).
/VAR marks the start of setting a variable. <nowiki>#</nowiki> is 0-24, 
where 0-9 correspond to NSIS variables $0-$9, 
and 10-19 correspond to NSIS variables $R0-$R9. 
20-24 are $CMDLINE, $INSTDIR, $OUTDIR, $EXEDIR, $LANGUAGE

The remaining arguments (if any) are the strings pushed onto
the stack and passed to the plugin. Strings are pushed on
the stack in opposite order from command line. That is,
pass arguments on the command line in same order as if you
were invoking the plugin from a NSIS script (calling order,
which should match order plugin pops them).

This is primarily meant as a debugging tool, so should be
modified if necessary to the plugin being tested, but
should work as it is for some. When using a debugger, one
should compile it with debugging information and the
plugin with debug information, then one can step through
them both and/or set break points. Only the input stack
and variables and then output stack and variables are
shown. When /nogui option is specified, NULL is passed
for the HWND as no window is created.

== Contact ==

Please send bug reports, suggestions, etc. to jeremyd --at--
fdos.org.

[[Category:Related Software]]

Plugin Tester (or Wrapper)

2006-11-22T17:57:09Z

PerditionC: /* Description */

{{PageAuthor|PerditionC}}

== Links ==
<attach>PlgnTester.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/plgnTester.0.01.zip PlgnTester.0.01.zip] (30 KB) (Mirror #1)

== Description ==
plgntester - NSIS Plugin Tester v0.01

This is a command line program that can be used to
invoke a NSIS plugin. It supports passing any string
variable on the stack, setting any of the standard
variables (user defined variables are unsupported),
and can invoke any specified function in given plugin.

== Usage ==
testwrap.exe plugin function {/VAR # str} [args]

Plugin is the name of the plugin (or dll) to load, passed
asis to LoadLibrary, so one can omit the .dll and normal
path search should be done, but if in the NSIS plugin
directory, you will need to explicitly provide its path.
An error message is returned if failed to load.

Function is the name of the exported function to invoke.
It should be exactly as exported, which should match
the name used in a NSIS script. An error message is
returned if function is not found or other error obtaining
its procedure address.

Any number (as permitted by the command line) of /VAR # str
sequences can be included (and in any location on cmd line).
/VAR marks the start of setting a variable. <nowiki>#</nowiki> is 0-24, 
where 0-9 correspond to NSIS variables $0-$9, 
and 10-19 correspond to NSIS variables $R0-$R9. 
20-24 are $CMDLINE, $INSTDIR, $OUTDIR, $EXEDIR, $LANGUAGE

The remaining arguments (if any) are the strings pushed onto
the stack and passed to the plugin. Strings are pushed on
the stack in opposite order from command line. That is,
pass arguments on the command line in same order as if you
were invoking the plugin from a NSIS script (calling order,
which should match order plugin pops them).

This is primarily meant as a debugging tool, so should be
modified if necessary to the plugin being tested, but
should work as it is for some. When using a debugger, one
should compile it with debugging information and the
plugin with debug information, then one can step through
them both and/or set break points. Only the input stack
and variables and then output stack and variables are
shown. Present version passes NULL for the HWND as no
window is created, though if requested, a future version may
add the necessary window. Future versions may also
add a /QUIET or /VERBOSE option allowing this to more
easily be used as a wrapper.

== Contact ==

Please send bug reports, suggestions, etc. to jeremyd --at--
fdos.org.

[[Category:Related Software]]

File:PlgnTester.zip

2006-11-22T17:52:30Z

PerditionC: NSIS Plugin Tester (Wrapper), allows executing functions exported from NSIS plugins without building a script and compiling it. Version 0.01 includes portions from NSIS exehead so can optionally display listbox for output to more accurately reflect plugi

NSIS Plugin Tester (Wrapper), allows executing functions exported from NSIS plugins without building a script and compiling it. Version 0.01 includes portions from NSIS exehead so can optionally display listbox for output to more accurately reflect plugin behaviour when used with a NSIS script. Primarily meant as a debugging tool, can be compiled with DEBUG information to allow easy stepping into a plugin's functions within a debugger.

Plugin Tester (or Wrapper)

2006-11-22T17:48:05Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
<attach>PlgnTester.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/plgnTester.0.01.zip PlgnTester.0.01.zip] (30 KB) (Mirror #1)

== Description ==
plgntester - NSIS Plugin Tester v0.00

This is a command line program that can be used to
invoke a NSIS plugin. It supports passing any string
variable on the stack, setting any of the standard
variables (user defined variables are unsupported),
and can invoke any specified function in given plugin.

== Usage ==
testwrap.exe plugin function {/VAR # str} [args]

Plugin is the name of the plugin (or dll) to load, passed
asis to LoadLibrary, so one can omit the .dll and normal
path search should be done, but if in the NSIS plugin
directory, you will need to explicitly provide its path.
An error message is returned if failed to load.

Function is the name of the exported function to invoke.
It should be exactly as exported, which should match
the name used in a NSIS script. An error message is
returned if function is not found or other error obtaining
its procedure address.

Any number (as permitted by the command line) of /VAR # str
sequences can be included (and in any location on cmd line).
/VAR marks the start of setting a variable. <nowiki>#</nowiki> is 0-24, 
where 0-9 correspond to NSIS variables $0-$9, 
and 10-19 correspond to NSIS variables $R0-$R9. 
20-24 are $CMDLINE, $INSTDIR, $OUTDIR, $EXEDIR, $LANGUAGE

The remaining arguments (if any) are the strings pushed onto
the stack and passed to the plugin. Strings are pushed on
the stack in opposite order from command line. That is,
pass arguments on the command line in same order as if you
were invoking the plugin from a NSIS script (calling order,
which should match order plugin pops them).

This is primarily meant as a debugging tool, so should be
modified if necessary to the plugin being tested, but
should work as it is for some. When using a debugger, one
should compile it with debugging information and the
plugin with debug information, then one can step through
them both and/or set break points. Only the input stack
and variables and then output stack and variables are
shown. Present version passes NULL for the HWND as no
window is created, though if requested, a future version may
add the necessary window. Future versions may also
add a /QUIET or /VERBOSE option allowing this to more
easily be used as a wrapper.

== Contact ==

Please send bug reports, suggestions, etc. to jeremyd --at--
fdos.org.

[[Category:Related Software]]

UnTGZ plug-in

2006-11-18T16:48:37Z

PerditionC: /* Usage */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 

Older releases may be found at http://www.darklogic.org/win32/nsis/plugins/. 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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).

[[Category:Plugins]]

UnTGZ plug-in

2006-11-18T16:47:58Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.13.zip Untgz.1.0.13.zip] (232 KB) (Mirror #1) 

Older releases may be found at http://www.darklogic.org/win32/nsis/plugins/. 
<attach>Untbgz.zip</attach> Older Untgz plugin with bz2 support, requires MSVCRT.DLL 

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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).

[[Category:Plugins]]

UnTGZ plug-in

2006-11-18T16:45:02Z

PerditionC: /* Description */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
<attach>Untbgz.zip</attach> Untgz plugin with bz2 support 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.11.zip Untgz.1.0.11.zip] (158 KB) (Mirror #1) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.12pre.zip Untgz.1.0.12pre.zip] (197 KB)

== Description ==
'''Version:''' 1.0.13

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). 

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). 

For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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).

[[Category:Plugins]]

UnTGZ plug-in

2006-11-13T23:46:46Z

PerditionC: /* Notes */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
<attach>Untbgz.zip</attach> Untgz plugin with bz2 support 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.11.zip Untgz.1.0.11.zip] (158 KB) (Mirror #1) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.12pre.zip Untgz.1.0.12pre.zip] (197 KB)

== Description ==
'''Version:''' 1.0.12

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).

Supports TAR files with no compression (*.tar), gzipped [zlib compatible] compression (*.tgz / *.tar.gz), and lzma compression (*.tlz / *.tar.lzma).

Original may be found at http://www.darklogic.org/win32/nsis/plugins/. 
For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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).

[[Category:Plugins]]

UnTGZ plug-in

2006-11-13T23:44:07Z

PerditionC: /* Usage */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
<attach>Untbgz.zip</attach> Untgz plugin with bz2 support 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.11.zip Untgz.1.0.11.zip] (158 KB) (Mirror #1) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.12pre.zip Untgz.1.0.12pre.zip] (197 KB)

== Description ==
'''Version:''' 1.0.12

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).

Supports TAR files with no compression (*.tar), gzipped [zlib compatible] compression (*.tgz / *.tar.gz), and lzma compression (*.tlz / *.tar.lzma).

Original may be found at http://www.darklogic.org/win32/nsis/plugins/. 
For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: if -k is specified will not overwrite existing files (keep)
: ''if -u is specified will only overwrite nonexisting or older files (update)'', INPROGRESS
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used prior to tar file name (tarball.tgz), however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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

[[Category:Plugins]]

UnTGZ plug-in

2006-11-13T23:40:59Z

PerditionC: /* Description */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
<attach>Untbgz.zip</attach> Untgz plugin with bz2 support 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.11.zip Untgz.1.0.11.zip] (158 KB) (Mirror #1) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.12pre.zip Untgz.1.0.12pre.zip] (197 KB)

== Description ==
'''Version:''' 1.0.12

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).

Supports TAR files with no compression (*.tar), gzipped [zlib compatible] compression (*.tgz / *.tar.gz), and lzma compression (*.tlz / *.tar.lzma).

Original may be found at http://www.darklogic.org/win32/nsis/plugins/. 
For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used, however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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

[[Category:Plugins]]

UnTGZ plug-in

2006-11-13T23:40:21Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
<attach>Untbgz.zip</attach> Untgz plugin with bz2 support 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.11.zip Untgz.1.0.11.zip] (158 KB) (Mirror #1) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.12pre.zip Untgz.1.0.12pre.zip] (197 KB)

== Description ==
'''Version:''' 1.0.11

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).

Supports TAR files with no compression (*.tar), gzipped [zlib compatible] compression (*.tgz / *.tar.gz), and lzma compression (*.tlz / *.tar.lzma).

Original may be found at http://www.darklogic.org/win32/nsis/plugins/. 
For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used, however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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

[[Category:Plugins]]

UnTGZ plug-in

2006-11-13T23:39:54Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
<attach>Untbgz.zip</attach> Untgz plugin with bz2 support 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.11.zip Untgz.1.0.11.zip] (158 KB) (Mirror #1)
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.12pre.zip Untgz.1.0.12pre.zip] (197 KB)

== Description ==
'''Version:''' 1.0.11

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).

Supports TAR files with no compression (*.tar), gzipped [zlib compatible] compression (*.tgz / *.tar.gz), and lzma compression (*.tlz / *.tar.lzma).

Original may be found at http://www.darklogic.org/win32/nsis/plugins/. 
For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used, however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be omitted (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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

[[Category:Plugins]]

MD5 plugin

2006-11-04T14:11:59Z

PerditionC: link to wikipedia description of what an MD5 hash is

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Md5dll.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/md5dll/md5dll.0.4.zip Md5dll.0.4.zip] (13 KB) (Mirror #1)

[http://www.darklogic.org/win32/nsis/plugins/md5dll/ Older Versions of MD5 plugin]

[http://forums.winamp.com/showthread.php?threadid=117789 Original NSIS Forums Thread (for older versions)]

== Description ==
Generates a [http://en.wikipedia.org/wiki/Md5 md5] value from either a string or contents of specified file.

Original: MD5 Plugin DLL by Matthew "IGx89" Lieder, derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm

== Sample Usage ==
<highlight-nsis>
OutFile "md5test.exe"
Section ""
#generate MD5sum of string
md5dll::GetMD5String "md5me"
Pop $0
DetailPrint "md5: [$0]"

# generate MD5sum of file
md5dll::GetMD5File "${NSISDIR}\makensis.exe"
Pop $0
DetailPrint "md5: [$0]"

#generate random MD5sum
md5dll::GetMD5Random
Pop $0
DetailPrint "md5: [$0]"
SectionEnd
</highlight-nsis>

== Versions History ==
;0.4
:KJD (2005):
:*Added dual name to exports for backwards compatibility.
;0.3
:Shengalts Aleksander aka Instructor (2005):
:*New command: "GetMD5Random".
:*Changed names: "GetFileMD5" -> "GetMD5File", "GetMD5" -> "GetMD5String".
:*Fixed: string length error.
;0.2
:Davy Durham (2004):
:*MD5.cpp fix (correct for loop used to replace memset, exceeded bounds).
;0.1
:KJD (2004):
:*Modified to reduce size and use exdll.h (reduced to about 6KB uncompressed, by removing CRTL dependency).
;Original
:Matthew "IGx89" Lieder:
:*Original plugin Author.
:Sunjammer (12th May 2002):
:*Original usage notes and example script.

[[Category:Plugins]]

MD5 plugin

2006-11-03T20:20:13Z

PerditionC: fix links to older versions

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Md5dll.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/md5dll/md5dll.0.4.zip Md5dll.0.4.zip] (13 KB) (Mirror #1)

[http://www.darklogic.org/win32/nsis/plugins/md5dll/ Older Versions of MD5 plugin]

[http://forums.winamp.com/showthread.php?threadid=117789 Original NSIS Forums Thread (for older versions)]

== Description ==
Generates a md5 value from either a string or contents of specified file.

Original: MD5 Plugin DLL by Matthew "IGx89" Lieder, derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm

== Sample Usage ==
<highlight-nsis>
OutFile "md5test.exe"
Section ""
#generate MD5sum of string
md5dll::GetMD5String "md5me"
Pop $0
DetailPrint "md5: [$0]"

# generate MD5sum of file
md5dll::GetMD5File "${NSISDIR}\makensis.exe"
Pop $0
DetailPrint "md5: [$0]"

#generate random MD5sum
md5dll::GetMD5Random
Pop $0
DetailPrint "md5: [$0]"
SectionEnd
</highlight-nsis>

== Versions History ==
;0.4
:KJD (2005):
:*Added dual name to exports for backwards compatibility.
;0.3
:Shengalts Aleksander aka Instructor (2005):
:*New command: "GetMD5Random".
:*Changed names: "GetFileMD5" -> "GetMD5File", "GetMD5" -> "GetMD5String".
:*Fixed: string length error.
;0.2
:Davy Durham (2004):
:*MD5.cpp fix (correct for loop used to replace memset, exceeded bounds).
;0.1
:KJD (2004):
:*Modified to reduce size and use exdll.h (reduced to about 6KB uncompressed, by removing CRTL dependency).
;Original
:Matthew "IGx89" Lieder:
:*Original plugin Author.
:Sunjammer (12th May 2002):
:*Original usage notes and example script.

[[Category:Plugins]]

Talk:UnTGZ plug-in

2005-07-14T23:15:29Z

PerditionC:

Nsisunz plug-in

2005-07-13T14:01:48Z

PerditionC: /* Download */

{{PageAuthor|saivert}}
=== NxS Unzip plug-in ===

== Download ==
[[Image:Zip.gif]] [http://saivert.inthegray.com/download.php?get=Li91cGxvYWRzL25zaXMvbnNpc3Vuei43eg== nsisunz.7z] (86.15 Kb) 

[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/nsisunz.7z nsisunz.7z] (86.15 Kb) (Mirror #2) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/nsisunz.zip nsisunz.alt.zip] (138 Kb) (reduced plugin size ''{40KB/22KB uncompressed/upx'd}'' version - limited testing) 

== Overview ==
nsisunz is a NSIS plugin which allows you to extract files from ZIP archives.

nsisunz is great when you use another NSIS plug-in named NSISdl to download a ZIP file from the internet. Download a small installer which lets the user choose the components he/she want to install and the installer downloads it (QuickTime Setup does this).

Note: nsisunz does not support password protected ZIP archives (encrypted).
To extract only a specific file from the archive use the "/file" option.

== How to use ==
Setting it up

To see a great example of how to use the plug-in, check out the included example script.

You use the Unzip, UnzipToLog or the UnzipToStack function to extract files from a ZIP archive.

In my opinion the best way to describe things is by showing an example, so here is one:
<highlight-nsis>
InitPluginsDir
; Call plug-in. Push filename to ZIP first, and the dest. folder last.
nsisunz::UnzipToLog "$PLUGINSDIR\myzipfile.zip" "$INSTDIR"

; Always check result on stack
Pop $0
StrCmp $0 "success" ok
DetailPrint "$0" ;print error message to log
ok:
</highlight-nsis>

<highlight-nsis>
; You can also use the "Unzip" function if you don't want to use the log.
; It is a lot quicker, and is preferred for large ZIP archives.
nsisunz::Unzip "$PLUGINSDIR\myzipfile.zip" "$INSTDIR"
The UnzipToStack function
</highlight-nsis>

The UnzipToStack function can be used instead of the UnzipToLog function if you want the extraction to be a lot faster when extracting from very large ZIP archives and still want to see the files extracted. This is how you use it:
<highlight-nsis>
nsisunz::UnzipToStack "$PLUGINSDIR\myzipfile.zip" "$INSTDIR"
Pop $0
StrCmp $0 "success" ok
DetailPrint "$0" ;print error message to log
Goto skiplist
ok:

; Print out list of files extracted to log
next:
Pop $0
DetailPrint $0
StrCmp $0 "" 0 next ; pop strings until a blank one arrives

skiplist:
</highlight-nsis>
== Extracting specific files ==

To extract only a specific file use the "/file" option like this:
<highlight-nsis>
nsisunz::UnzipToLog /file "AnyPathInsideZIP/AFile.txt" "myzip.zip" "c:\myfiles"
</highlight-nsis>
The path is relative to the root of the ZIP archive so you don't have to prepend a slash ("/"). Furthermore the foldernames are extracted with the file so the example above creates a file named "c:\myfiles\AnyPathInsideZIP\AFile.txt". To avoid this use "/noextractpath" like this:
<highlight-nsis>
nsisunz::UnzipToLog /noextractpath /file \
"AnyPathInsideZIP/AFile.txt" "myzip.zip" "c:\myfiles"
</highlight-nsis>
== Using nsisunz with NSISdl ==

To use NSISdl with nsisunz to download and extract a ZIP archive, do something like this:
<highlight-nsis>
InitPluginsDir
NSISdl::download http://www.domain.com/file "$PLUGINSDIR\localfile.zip"
Pop $R0 ;Get the return value
StrCmp $R0 "success" +3
MessageBox MB_OK "Download failed: $R0"
Quit

nsisunz::UnzipToLog "$PLUGINSDIR\localfile.zip" "$INSTDIR"
Pop $R0
StrCmp $R0 "success" +2
DetailPrint "$R0" ;print error message to log
</highlight-nsis>
== Options ==

These are the optional parameters you can specify when calling nsisunz.

/noextractpath
This option makes the plug-in extract all files to the destination directory
without regard to paths stored in ZIP file. Is often used in conjunction
with "/file" to extract a single file from anywhere in an archive to a
destination directory.

/file
Extract a specific file. Filename must be specified as next parameter and must
match a file in the ZIP including any subdirectories. If the file couldn't be
found in the ZIP file, nsisunz pushes the string "File not found in ZIP
file" on the stack.

/text
Sets the format of the text used in the log to the next param. "%f" is
replaced with the filename, "%c" is replaced with the compressed size and
"%u" is replaced with the uncompressed size.

== Return value ==

After you have called the DLL, nsisunz adds either "success" or a specific error message on the stack. This is the possible error messages:
Error opening ZIP file
Error opening output file(s)
Error writing output file(s)
Error extracting from ZIP file
File not found in ZIP file

Usually, you don't need to check this value, but you still have to remove it from the stack (have a look at the example above).
Reserve files

If you are using BZIP2 (solid) compression, it's important that files which are being extracted in init- or page functions function are located before other files in the data block, because this will make your installer faster.

If there are File commands in your sections or functions above the init- or page functions, add ReserveFile commands above your sections and functions:
<highlight-nsis>
ReserveFile "myzipfile.zip"
ReserveFile "${NSISDIR}\Plugins\nsisunz.dll"
</highlight-nsis>

== Localization ==

Use the "/text" parameter to localize the text used by nsisunz for the log output.
<highlight-nsis>
; Localized strings for use with nsisunz
; The "%f" in the string is replaced with the filename on run-time.
; "%c" and "%u" is replaced with compressed size and
; uncompressed size respectively. See example script.

LoadLanguageFile "${NSISDIR}\Contrib\Language files\english.nlf"
LoadLanguageFile "${NSISDIR}\Contrib\Language files\norwegian.nlf"

LangString nsisunz_text ${LANG_ENGLISH} "Extract: %f"
LangString nsisunz_text ${LANG_NORWEGIAN} "Pakk ut: %f"

Function .onInit
nsisunz:: /text "" "$(nsisunz_text)"
FunctionEnd
</highlight-nsis>

== Notes ==

The plug-in is compressed with UPX to make it smaller.
If you make changes to the source, re-compile and use UPX you may get this message:
upx: nsisunz.dll: CantPackException: file is possibly packed/protected (try --force)
I used the "--force" parameter as proposed, and without problems UPX reduced the size of nsisunz.dll from ~71 kb to 31,5 kb
The reason for why you get this message is that the source #include's "AggressiveOptimize.h" which makes the linker merge the code sections of the final executable. This makes UPX think it's already packed (which it kinda is). But by using the "--force" parameter, UPX may shrink it a lot more.
I hope people appreciate my struggles to keep the size of the plug-in small. If someone have any suggestions for making it even smaller I would like if someone sendt me an e-mail.

== Contact ==

nsisunz is written by Saivert.
Homepage: http://saivert.inthegray.com/
E-mail: saivert@gmail.com
Version history
DLL version 1.0 (12/4/2004)
First public release!

== Credits ==

Based on code in NSIS Zip2Exe
portions Copyright Â© 1999-2001 Miguel Garrido (mgarrido01@hotmail.com)
Uses ZLIB - Copyright Â© Mark Adler
ZIP format routines - Copyright Â© 1998 Gilles Vollant
Thanks to Tim Kosse for the LogMessage function, even though I could figure this out myself.
And thanks to Joost Verburg for the readme HTML page design.

== License ==

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute
it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented;
you must not claim that you wrote the original software.
If you use this software in a product, an acknowledgment in the
product documentation would be appreciated but is not required.
2. Altered versions must be plainly marked as such,
and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any distribution.

[[Category:Plugins]]

UnTGZ plug-in

2005-07-03T19:52:22Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Untgz.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/untgz.1.0.10.zip Untgz.1.0.10.zip] (158 KB) (Mirror #1)

== Description ==
'''Version:''' 1.0.10.

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).

Supports TAR files with no compression (*.tar), gzipped [zlib compatible] compression (*.tgz / *.tar.gz), and lzma compression (*.tlz / *.tar.lzma).

Original may be found at http://www.darklogic.org/win32/nsis/plugins/. 
For problems, corrections, etc. send email to jeremyd --at-- fdos.org

== Usage ==
; '''untgz<nowiki>::</nowiki>extract''' [''-j''] [''-d basedir''] [''-k''] [''-z<type>''] tarball.tgz
: extracts all files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: 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}''] '''--'''
: extracts files from tarball.tgz
: if -j is specified then ignore paths in tarball (junkpaths)
: if -d is specified will extract relative to basedir
: ''if -k is specified will not overwrite existing files (keep)'', NOT YET IMPLEMENTED
: if -z is specified determines compression used, see below
: if -i is specified will only extract files whose filename matches
: if -x is specified will NOT extract files whose filename matches
: the -- is required and marks the end of the file lists

; '''untgz<nowiki>::</nowiki>extractFile''' [''-d basedir''] [''-z<type>''] tarball.tgz file
: extracts just the file specified
: path information is ignored, implictly -j is specified (may also be explicit)

;For compatibility with tar command, the following option specifiers may be used, however, they are simply ignored.
: -x indicates action to perform is extraction (extract)
: -f archive-name indicates name of tarball (filename), note even when used, the filename must be last argument

;If the tarball uses a compression other than gz, then the '''-z''<type>''''' option must be specified to indicate how tar file is compressed.
: -z indicates gzip (.tgz/.tar.gz) compression, uses zlib, this is the default if -z<type> option is omitted
: -znone indicates uncompressed tar file (.tar), may be ommited (internally same as -z)
: -zlzma indicates lzma (.tlz/.tar.lzma) compression
: -zbz2 indicates bzip2 (.tbz/.tar.bz2) compression, NOT YET IMPLEMENTED

;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.

== Example usage ==
This is a snippet from [[AbiWord]]'s NSIS2 script:
<highlight-nsis> doDictInst:
; Unzip dictionary into dictionary subdirectory
untgz::extract "-j" "-d" "$INSTDIR\dictionary" "$TEMP\${DICT_FILENAME}"

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

Finish:
</highlight-nsis>

== Notes ==
Currently tested with NSIS 2.0x

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.
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'

[[Category:Plugins]]

Nsisdbg plug-in

2005-07-03T19:48:42Z

PerditionC: /* Introduction */

{{PageAuthor|saivert}}

== Links ==
[[File:Exe.gif]] [http://saivert.inthegray.com/download.php?get=Li91cGxvYWRzL25zaXMvbnNpcy1kZWJ1Z2dlci5leGU= nsis-debugger.exe] (275 KB) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/others/nsis-debugger.exe nsis-debugger.exe] (275 KB) (Mirror #2)

== Introduction ==
I have created a new debug tool for NSIS. It's called NSIS Debugger and
you can download it from my homepage (see above links section).

NSIS Debugger is a NSIS plugin which allows you to debug
your NSIS installers. The plugin will create a dialog which will be displayed
alongside the NSIS window. The first thing you will get familiar with is the tabbed pages.
Use them to switch between variable list, stack view, debug log, config. and about page.

== Description ==
Using the variable list which is on the first tab page
you can change all the variables, clear them, keep (save for later use) and restore them
(from a previous keep operation). To edit a variable simply use the in-place edit box by clicking a variable.
The stack view gives you a list of the strings pushed on the stack. You can pop them off it,
push more strings to it and clear the entire stack. You can edit a stack item simply by clicking it and use
the in-place editbox.
NSIS Debugger has a debug log which you can add entries to by calling a function
in your installer script.

To install the plugin, simply copy it to the plugins folder under your NSIS folder.

This version of NSIS Debugger has only been tested with NSIS 2.
It should work perfectly fine with older versions too.

== How to use ==

Initialization
The first thing you have to do to use the debugger is to
set up a couple of lines in the .onGUIInit callback function in the script.
You will also need to put a line in the .onGUIEnd callback function as well
(this is covered below).
<highlight-nsis>
Function .onGUIInit

InitPluginsDir
; Remember to include the "/NOUNLOAD" option.
; This is to keep the debugger running.
nsisdbg::init /NOUNLOAD
; To start the debugger hidden pass "hidded"
; to the stack like this:
; nsisdbg::init /NOUNLOAD "hidden"
; You will be able to show it again by using the
; system menu of the installer. Read about this below.

; old fashion way (pre-2.0)
; GetTempFileName $9 ; $9 will globally be used in the script
; File /oname=$9 ${NSISDIR}\Plugins\nsisdbg.dll
; CallInstDLL $9 /NOUNLOAD init

; optionally set a few option by calling setoption
nsisdbg::setoption /NOUNLOAD "notifymsgs" "1"
; read more about the setoption function below
FunctionEnd
</highlight-nsis>
== Use the debug log ==
Now as you have the debugger up and running, let's use the debug log feature.
Call sendtolog like in this example
<highlight-nsis>
nsisdbg::sendtolog /NOUNLOAD "Value of $$1 is $1"
; Only push one string. Subsequent strings will be left on the stack.

; old fashion way (pre-2.0)
Push "Value of $$1 is $1"
CallInstDLL $9 /NOUNLOAD sendtolog
</highlight-nsis>

[[Category:Plugins]]

Nsisdbg plug-in

2005-07-03T19:47:38Z

PerditionC: /* Links */

{{PageAuthor|saivert}}

== Links ==
[[File:Exe.gif]] [http://saivert.inthegray.com/download.php?get=Li91cGxvYWRzL25zaXMvbnNpcy1kZWJ1Z2dlci5leGU= nsis-debugger.exe] (275 KB) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/others/nsis-debugger.exe nsis-debugger.exe] (275 KB) (Mirror #2)

== Introduction ==
I have created a new debug tool for NSIS. It's called NSIS Debugger and
you can download it from my homepage below.

NSIS Debugger is a NSIS plugin which allows you to debug
your NSIS installers. The plugin will create a dialog which will be displayed
alongside the NSIS window. The first thing you will get familiar with is the tabbed pages.
Use them to switch between variable list, stack view, debug log, config. and about page.

== Description ==
Using the variable list which is on the first tab page
you can change all the variables, clear them, keep (save for later use) and restore them
(from a previous keep operation). To edit a variable simply use the in-place edit box by clicking a variable.
The stack view gives you a list of the strings pushed on the stack. You can pop them off it,
push more strings to it and clear the entire stack. You can edit a stack item simply by clicking it and use
the in-place editbox.
NSIS Debugger has a debug log which you can add entries to by calling a function
in your installer script.

To install the plugin, simply copy it to the plugins folder under your NSIS folder.

This version of NSIS Debugger has only been tested with NSIS 2.
It should work perfectly fine with older versions too.

== How to use ==

Initialization
The first thing you have to do to use the debugger is to
set up a couple of lines in the .onGUIInit callback function in the script.
You will also need to put a line in the .onGUIEnd callback function as well
(this is covered below).
<highlight-nsis>
Function .onGUIInit

InitPluginsDir
; Remember to include the "/NOUNLOAD" option.
; This is to keep the debugger running.
nsisdbg::init /NOUNLOAD
; To start the debugger hidden pass "hidded"
; to the stack like this:
; nsisdbg::init /NOUNLOAD "hidden"
; You will be able to show it again by using the
; system menu of the installer. Read about this below.

; old fashion way (pre-2.0)
; GetTempFileName $9 ; $9 will globally be used in the script
; File /oname=$9 ${NSISDIR}\Plugins\nsisdbg.dll
; CallInstDLL $9 /NOUNLOAD init

; optionally set a few option by calling setoption
nsisdbg::setoption /NOUNLOAD "notifymsgs" "1"
; read more about the setoption function below
FunctionEnd
</highlight-nsis>
== Use the debug log ==
Now as you have the debugger up and running, let's use the debug log feature.
Call sendtolog like in this example
<highlight-nsis>
nsisdbg::sendtolog /NOUNLOAD "Value of $$1 is $1"
; Only push one string. Subsequent strings will be left on the stack.

; old fashion way (pre-2.0)
Push "Value of $$1 is $1"
CallInstDLL $9 /NOUNLOAD sendtolog
</highlight-nsis>

[[Category:Plugins]]

HelpButton plug-in

2005-07-03T19:44:05Z

PerditionC: /* Links */

{{PageAuthor|DrO}}

== Links ==
[[Image:Zip.gif]] [http://forums.winamp.com/attachment.php?s=&postid=1143621 Helpbutton_v0_9.zip] (73 KB) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/others/helpbutton_v0_9.zip Helpbutton_v0_9.zip] (73 KB) (Mirror #2) 

[http://forums.winamp.com/showthread.php?s=&threadid=149292 Forums Topic]

== Description ==
'''Version:''' 0.9

Now you can have help support at the click of a button or a press of the key. This plugin will allow you to click on customisable button or to press the 'F1' key to open a information window which you decide what it is that you will show.

You can view plain text, rich text or html (support is basic at the moment) and you can use files to store the information in (ideal for rich text and html!).

The current features are:

*add a button onto a page where you want it to go (resizes to the text)
*define your own button text e.g. "Help" or "Readme..." or hide it if you want
*show text you set in the script or use a file
*support for plain text, rich text and not forgetting html files
*opens the information when pressing 'F1'
*works on a per page method and it is possible to get a button shown after installation has happened :o)

== Syntax ==
<highlight-nsis>
<nowiki>::show</nowiki> /NOUNLOAD (x, y) button_text window_title window_text [option1 option2]
</highlight-nsis>

; /NOUNLOAD
: please note that '''THIS IS NEEDED''' otherwise the installer is likely to crash or the button will not work or be correctly removed! (This is due to the way the button is implemented, a work around was possible but when run under NT4 the plugin would crash.)

; (x, y)
: this sets the top left corner of the button with respect to the installer's top left corner

; button_text
: this is the text that is displayed on the button with the button resizing to allow it to correctly appear. if no text is passed in then the button will be hidden

; window_title
: this is what the information window will display

; window_text
: this the text that the window will show which can be text in the script or using /file= or /html= can specify a file to be used (full path to the file)

; '''option1''' and '''option2'''
: if using text files or text in the script then there are two optional settings currently available

:; wrap
:: this will turn wordwrapping of the window on (default is '''off''')

:; font
:: if using plain text then this sets the font size to use (currently the installer's font is used for the window text) (default is the current installer font size)

<highlight-nsis>
<nowiki>::end</nowiki>
</highlight-nsis>

this takes no parameters and '''MUST''' be used once you have finished using the feature on your page or the best option is when the installer exits and is best to use .onGUIend (or the MUI eqivalent).

If you don't do this then it is unlikely that the installer will crash but the dll will not be unloaded and so will stay on the hard drive which is not friendly to the person using the installer ;o)

== TODO List ==
* better / tidier example of the code
* better control over the font to use with text files
* other suggestions :o)

[[Category:Plugins]]

RfshDktp plug-in

2005-07-03T19:40:22Z

PerditionC: /* Links */

{{PageAuthor|scully13}}

== Links ==
<attach>Rfshdktp.zip</attach> 
[[Image:Zip.gif]] [http://home.swbell.net/andygib/rfshdktp.zip Rfshdktp.zip] (3 KB) (Mirror #1) 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/others/rfshdktp.zip Rfshdktp.zip] (3 KB) (Mirror #2)

The zip file contains the DLL, the VC++ 6.0 source code and an example NSIS script for using the DLL. The script has an example of when the desktop shortcuts get messed up and need refreshing.

== Description ==
The refresh desktop plugin does just what it says. A few people said they were able to do it using a SendMessage but that never seemed to work for what I needed it for. From time to time Windows seemed to have a bug when creating a desktop shortcut. It would cause an extra shortcut to show up on the desktop that wasn't valid. Hitting F5 or right-clicking and choosing Refresh always made it go away so I made this DLL to handle that.

== Usage ==
<highlight-nsis>
; call the DLL to refresh the desktop
rfshdktp::refreshDesktop
</highlight-nsis>

-scully13

[[Category:Plugins]]

MD5 plugin

2005-07-03T17:58:30Z

PerditionC: /* Sample Usage */

{{PageAuthor|PerditionC}}

== Links ==
Download: 
<attach>Md5dll.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/md5dll/md5dll.0.4.zip Md5dll.0.4.zip] (13 KB) (Mirror #1)

[http://www.darklogic.org/win32/nsis/plugins/md5dll/ Older Versions of MD5 plugin]

== Description ==
Generates a md5 value from either a string or contents of specified file.

Original: MD5 Plugin DLL by Matthew "IGx89" Lieder, derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm

== Sample Usage ==
<highlight-nsis>
OutFile "md5test.exe"
Section ""
#generate MD5sum of string
md5dll::GetMD5String "md5me"
Pop $0
DetailPrint "md5: [$0]"

# generate MD5sum of file
md5dll::GetMD5File "${NSISDIR}\makensis.exe"
Pop $0
DetailPrint "md5: [$0]"

#generate random MD5sum
md5dll::GetMD5Random
Pop $0
DetailPrint "md5: [$0]"
SectionEnd
</highlight-nsis>

== Versions History ==
;0.4
::KJD (2005):
::*Added dual name to exports for backwards compatibility.
;0.3
::Shengalts Aleksander aka Instructor (2005):
::*New command: "GetMD5Random".
::*Changed names: "GetFileMD5" -> "GetMD5File", "GetMD5" -> "GetMD5String".
::*Fixed: string length error.
;0.2
::Davy Durham (2004):
::*MD5.cpp fix (correct for loop used to replace memset, exceeded bounds).
;0.1
::KJD (2004):
::*Modified to reduce size and use exdll.h (reduced to about 6KB uncompressed, by removing CRTL dependency).
;Original
::Matthew "IGx89" Lieder:
::*Original plugin Author.
::Sunjammer (12th May 2002):
::*Original usage notes and example script.

[[Category:Plugins]]

MD5 plugin

2005-07-03T15:53:48Z

PerditionC: /* Links */

{{PageAuthor|PerditionC}}

== Links ==
<attach>Md5dll.0.3.zip</attach> 
[[Image:Zip.gif]] [http://www.darklogic.org/win32/nsis/plugins/md5dll/md5dll.0.4.zip Md5dll.0.4.zip] (14 KB) (Mirror #1)

[http://www.darklogic.org/win32/nsis/plugins/md5dll/ Older Versions of MD5 plugin]

== Description ==
Generates a md5 value from either a string or contents of specified file.

Original: MD5 Plugin DLL by Matthew "IGx89" Lieder, derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm

== Sample Usage ==
<highlight-nsis>
OutFile "md5test.exe"
Section ""
md5dll::GetMD5String "md5me"
Pop $0
DetailPrint "md5: [$0]"

md5dll::GetMD5File "${NSISDIR}\makensis.exe"
Pop $0
DetailPrint "md5: [$0]"
SectionEnd
</highlight-nsis>

[[Category:Plugins]]