process-metrics 0.10.1 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ba73a437e475ddef14fcc6359ccda80005af948d51f8ee16948483745e31808
-  data.tar.gz: 91cdd79dda0ec324cb537e4e7f507a858b79cd0fe3adb67b7d216176557eb2ff
+  metadata.gz: 213edfd5fbe960b9a75ac7574f17828f6b9f24ec5328ebf8c6ee85dcafeae0c2
+  data.tar.gz: 8daf591b9691f058dbe87dd861c0d8ff2e2669edff94b098ad0de36440963b14
 SHA512:
-  metadata.gz: 31588e588c2f4dd68a44072876e2dee6fa22a04226c23e937020ee4055a433bc5b90f8e90c016c470d00a44b50fc7d63d951c04566baba103247a2ed0c67f194
-  data.tar.gz: 6b14d2d59122a4b7ef6df058102e7631623e6abe3f8be0f743c0653e31f44e0436f269b43aa3cc398c4bcd562cd7572ba867f5a33abf72c1ca186999392d7be3
+  metadata.gz: 7cfafb180bf9286f5eb35dd2d5393b77ca88fc86f8b93509aed2f30870255dbba5e617ceceb69c17607bc3e620b7599e8c11ab960323033a97087a2acc45340c
+  data.tar.gz: 78427458c5dd06674690a1fe3ffab4d1c85a6ce265defce5dc2191be874ee995c87299c86de9b83e88e84318425ca2b16361e69df4b9d26d4badca1dbb8078e7

data/lib/process/metrics/memory.rb

@@ -23,11 +23,30 @@ module Process
 				self.resident_size + self.swap_size
 			end
 			
-			# The unique set size, the size of completely private (unshared) data.
-			def unique_size
+			# The private set size, the size of completely private (unshared) data.
+			# This is the sum of Private_Clean and Private_Dirty pages.
+			# @returns [Integer] Total private memory in bytes.
+			def private_size
 				self.private_clean_size + self.private_dirty_size
 			end
 			
+			# The private set size is also known as the unique set size.
+			alias unique_size private_size
+			
+			# The total size of shared (potentially shared with other processes) memory.
+			# This is the sum of Shared_Clean and Shared_Dirty pages.
+			#
+			# When tracking Copy-on-Write (CoW) activity in forked processes:
+			# - Initially, most memory is shared between parent and child.
+			# - As the child writes to memory, CoW triggers and shared pages become private.
+			# - Tracking shared_size decrease vs unique_size increase can indicate CoW activity.
+			# - If shared_size decreases by X and unique_size increases by ~X, it's likely CoW.
+			#
+			# @returns [Integer] Total shared memory in bytes.
+			def shared_size
+				self.shared_clean_size + self.shared_dirty_size
+			end
+			
 			# Create a zero-initialized Memory instance.
 			# @returns [Memory] A new Memory object with all fields set to zero.
 			def self.zero

data/lib/process/metrics/version.rb

@@ -7,6 +7,6 @@
 module Process
 	# @namespace
 	module Metrics
-		VERSION = "0.10.1"
+		VERSION = "0.10.2"
 	end
 end

data/readme.md

@@ -16,6 +16,10 @@ Please see the [project documentation](https://socketry.github.io/process-metric
 
 Please see the [project releases](https://socketry.github.io/process-metrics/releases/index) for all releases.
 
+### v0.10.2
+
+  - Add `Process::Metrics::Memory#private_size` for the sum of private (unshared) pages (Private\_Clean + Private\_Dirty); `#unique_size` is now an alias for `#private_size`.
+
 ### v0.10.1
 
   - Consistent use of `_size` suffix.
@@ -58,12 +62,6 @@ Please see the [project releases](https://socketry.github.io/process-metrics/rel
   - Improved support for proportional memory usage (PSS).
   - Exposed total system memory information.
 
-### v0.4.0
-
-  - Fixed command formatting in output display.
-  - Modernized codebase to use current Ruby conventions.
-  - Improved Darwin (macOS) support with better platform-specific handling.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.10.2
+
+  - Add `Process::Metrics::Memory#private_size` for the sum of private (unshared) pages (Private\_Clean + Private\_Dirty); `#unique_size` is now an alias for `#private_size`.
+
 ## v0.10.1
 
   - Consistent use of `_size` suffix.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: process-metrics
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.10.2
 platform: ruby
 authors:
 - Samuel Williams