X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Fp5-Linux-Proc-Maps;a=blobdiff_plain;f=README.md;fp=README.md;h=3bc06f0fbf976f2b2b3b6f52a670b28c2392a089;hp=cbf3513e6e293ac148c7f70fb3f0543ee67276c7;hb=c4949893b4c5b38119e1ad09dff3115d5be8b4ed;hpb=7c1bb3f368b9b8143877794f134970ce77b7d2ac diff --git a/README.md b/README.md index cbf3513..3bc06f0 100644 --- a/README.md +++ b/README.md @@ -25,21 +25,25 @@ This module reads and writes `/proc/[pid]/maps` files that contain listed mapped # METHODS -## read\_maps %args +## read\_maps Read and parse a maps file, returning an arrayref of regions (each represented as a hashref). See ["parse\_maps\_single\_line"](#parse_maps_single_line) to see the format of the hashrefs. + my $regions = read_maps(%args); + Arguments: - `file` - Path to maps file - `pid` - Process ID (one of `file` or `pid` is required) - `mnt` - Absolute path where [proc(5)](http://man.he.net/man5/proc) is mounted (optional, default: `/proc`) -## write\_maps \\@regions, %args +## write\_maps Returns a string with the contents of a maps file from the memory regions passed. + my $file_content = write_maps(\@regions, %args); + This is the opposite of ["read\_maps"](#read_maps). Arguments: @@ -47,10 +51,12 @@ Arguments: - `fh` - Write maps to this open file handle (optional) - `file` - Open this filepath and write maps to that file (optional) -## parse\_maps\_single\_line $line +## parse\_maps\_single\_line Parse and return a single line from a maps file into a region represented as a hashref. + my $region = parse_maps_single_line($line); + For example, # address perms offset dev inode pathname @@ -71,10 +77,12 @@ becomes: pathname => '/usr/sbin/gpm', } -## format\_maps\_single\_line \\%region +## format\_maps\_single\_line Return a single line for a maps file from a region represented as a hashref. + my $line = format_maps_single_line(\%region); + This is the opposite of ["parse\_maps\_single\_line"](#parse_maps_single_line). # SEE ALSO