TruxtonMedia - Revision history

Sam at 11:44, 16 August 2025

2025-08-16T11:44:41Z

Sam at 19:20, 25 March 2025

2025-03-25T19:20:34Z

Sam: /* save() -> str */

2024-02-25T19:28:06Z

save() -> str

Sam at 12:40, 3 February 2024

2024-02-03T12:40:43Z

Sam: /* Sample */

2024-01-27T19:11:30Z

Sample

Sam: /* Sample */

2023-05-03T08:39:48Z

Sample

Sam: /* Sample */

2023-05-03T08:39:25Z

Sample

Sam: /* finished() */

2023-05-03T08:38:10Z

finished()

Sam at 22:25, 2 May 2023

2023-05-02T22:25:32Z

Sam at 11:27, 1 October 2022

2022-10-01T11:27:55Z

@@ Line 76: / Line 76: @@
 This will commit the information to the <code>[Media]</code> table.
 It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
 ==<code>status: int</code>==

@@ Line 43: / Line 43: @@
 By default, the expiration date of media is 99 years from the creation of the media.
-==<code>finished() -> boolean</code>==
+==<code>finish() -> boolean</code>==
 Once media has been saved, if you have added any files to the media, call this method.
 It will update paths and child file counts.

@@ Line 73: / Line 73: @@
 This corresponds to the <code>[PercentComplete]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
-==<code>save() -> str</code>==
+==<code>save() -> boolean</code>==
 This will commit the information to the <code>[Media]</code> table.
 It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.

@@ Line 17: / Line 17: @@
 A case number for this media.
 Even though media came in under one case doesn't mean it can't be part of another.
-This corresponds to the <code>[CaseNumber]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[CaseNumber]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>configid: int</code>==
 This is the path the media took through the exploitation process.
-This corresponds to the <code>[LoadConfigurationID]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[LoadConfigurationID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 It should be set to one of the values in the <code>[ID]</code> column of the <code>[LoadConfiguration]</code> table or a predefined constant.
@@ Line 27: / Line 27: @@
 When the media was created.
 This value can be set with either a datetime value or an integer representing [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-This corresponds to the <code>[Created]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Created]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>description: str</code>==
 A description of the media.
-This corresponds to the <code>[Description]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Description]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>evidencebag: str</code>==
 A description of the media.
-This corresponds to the <code>[EvidenceBag]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[EvidenceBag]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>expires: [https://docs.python.org/3/library/datetime.html datetime]</code>==
 When the media should be automatically purged from Truxton.
 This value can be set with either a datetime value or an integer representing [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-This corresponds to the <code>[Expires]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Expires]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 By default, the expiration date of media is 99 years from the creation of the media.
@@ Line 49: / Line 49: @@
 ==<code>id: str</code>==
 A [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] for the media.
-This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>latitude: float</code>==
 The [https://en.wikipedia.org/wiki/Latitude latitude] portion of the geographic coordinate using the [https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84 WGS84] ellipsoid of where this media was seized.
-This corresponds to the <code>[Latitude]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Latitude]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>longitude: float</code>==
 The [https://en.wikipedia.org/wiki/Longitude longitude] portion of the geographic coordinate using the [https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84 WGS84] ellipsoid of where this media was seized.
 Many thanks go to [https://en.wikipedia.org/wiki/John_Harrison John Harrison] for his work.
-This corresponds to the <code>[Longitude]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Longitude]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>name: str</code>==
 This is a human friendly name for the media.
-This corresponds to the <code>[Name]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Name]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>originator: str</code>==
 The name of the organization or person who is responsible for this media.
 For example, if you are a regional center, this would identify the originating organization that asked you to look at the media.
-This corresponds to the <code>[Originator]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[Originator]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>percentcomplete: int</code>==
 An estimation of how [[ETL Stages#ETLs and Their Stages | far along]] the system is in the exploitation of this media.
-This corresponds to the <code>[PercentComplete]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[PercentComplete]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 ==<code>save() -> str</code>==
@@ Line 79: / Line 79: @@
 ==<code>status: int</code>==
 The represents the status of the media.
-This corresponds to the <code>[MediaStatusID]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[MediaStatusID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
-It should be a value from the <code>[ID]</code> column of the <code>[MediaStatus]</code> table or a [[Media Status | predefined constant.]]
+It should be a value from the <code>[ID]</code> column of the <code>[MediaStatus]</code> table or a [[Media Status|predefined constant.]]
 ==<code>tag(tag: str, reason: str, origin: int) -> boolean</code>==
@@ Line 92: / Line 92: @@
 ==<code>type: int</code>==
 The is an identifier for the type of media that was loaded.
-This corresponds to the <code>[MediaTypeID]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[MediaTypeID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 It should be a value from the <code>[ID]</code> column of the <code>[MediaType]</code> table or a [[Media Types | predefined constant.]]
@@ Line 98: / Line 98: @@
 When the media was last updated.
 This value can be set with either a datetime value or an integer representing [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-This corresponds to the <code>[LastUpdated]</code> column of the <code>[Media]</code> table.
+This corresponds to the <code>[LastUpdated]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 =Sample=

@@ Line 180: / Line 180: @@
 if __name__ == "__main__":
-   main()
+   sys.exit(main())
 </source>

@@ Line 145: / Line 145: @@
    gps.longitude = -0.124057
    gps.label = "HQ"
-   gps.when= date_to_filetime(datetime.fromisoformat("2016-04-01T12:00:00-05:00"))
+   gps.when= datetime.fromisoformat("2016-04-01T12:00:00-05:00")
    gps.save()

@@ Line 101: / Line 101: @@
 =Sample=
-<source lang="Python" highlight="30-38,77">
+<source lang="Python" highlight="24-32,71">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')
@@ Line 110: / Line 110: @@
 from calendar import timegm
 from pathlib import Path
 EVENT_TYPE_FBI = 20001
 def add_file(parent_truxton_file, filename):

@@ Line 2: / Line 2: @@
 =Attributes and Methods=
 ==<code>addroot() -> [[TruxtonChildFileIO]]</code>==
 This method will create a root file in the media.