+#. type: =head1
+#: ../src/guestfs.pod:2168
+msgid "SYSTEMTAP"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2170
+msgid ""
+"The libguestfs C library can be probed using systemtap or DTrace. This is "
+"true of any library, not just libguestfs. However libguestfs also contains "
+"static markers to help in probing internal operations."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2174
+msgid "You can list all the static markers by doing:"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2176
+#, no-wrap
+msgid ""
+" stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n"
+" .provider(\"guestfs\").mark(\"*\")'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2179
+msgid ""
+"B<Note:> These static markers are I<not> part of the stable API and may "
+"change in future versions."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs.pod:2182
+msgid "SYSTEMTAP SCRIPT EXAMPLE"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2184
+msgid ""
+"This script contains examples of displaying both the static markers and some "
+"ordinary C entry points:"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2187
+#, no-wrap
+msgid ""
+" global last;\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2189
+#, no-wrap
+msgid ""
+" function display_time () {\n"
+" now = gettimeofday_us ();\n"
+" delta = 0;\n"
+" if (last > 0)\n"
+" delta = now - last;\n"
+" last = now;\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2196
+#, no-wrap
+msgid ""
+" printf (\"%d (+%d):\", now, delta);\n"
+" }\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2199
+#, no-wrap
+msgid ""
+" probe begin {\n"
+" last = 0;\n"
+" printf (\"ready\\n\");\n"
+" }\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2204
+#, no-wrap
+msgid ""
+" /* Display all calls to static markers. */\n"
+" probe process(\"/usr/lib*/libguestfs.so.0\")\n"
+" .provider(\"guestfs\").mark(\"*\") ? {\n"
+" display_time();\n"
+" printf (\"\\t%s %s\\n\", $$name, $$parms);\n"
+" }\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2211
+#, no-wrap
+msgid ""
+" /* Display all calls to guestfs_mkfs* functions. */\n"
+" probe process(\"/usr/lib*/libguestfs.so.0\")\n"
+" .function(\"guestfs_mkfs*\") ? {\n"
+" display_time();\n"
+" printf (\"\\t%s %s\\n\", probefunc(), $$parms);\n"
+" }\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2218
+msgid ""
+"The script above can be saved to C<test.stap> and run using the L<stap(1)> "
+"program. Note that you either have to be root, or you have to add yourself "
+"to several special stap groups. Consult the systemtap documentation for "
+"more information."
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2223
+#, no-wrap
+msgid ""
+" # stap /tmp/test.stap\n"
+" ready\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2226
+msgid "In another terminal, run a guestfish command such as this:"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs.pod:2230
+msgid "In the first terminal, stap trace output similar to this is shown:"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs.pod:2232
+#, no-wrap
+msgid ""
+" 1318248056692655 (+0):\tlaunch_start\n"
+" 1318248056692850 (+195): launch_build_appliance_start\n"
+" 1318248056818285 (+125435): launch_build_appliance_end\n"
+" 1318248056838059 (+19774): launch_run_qemu\n"
+" 1318248061071167 (+4233108): launch_end\n"
+" 1318248061280324 (+209157): guestfs_mkfs g=0x1024ab0 fstype=0x46116f "
+"device=0x1024e60\n"
+"\n"
+msgstr ""
+
git.annexia.org / libguestfs.git / blobdiff