Hello community, here is the log from the commit of package perl-Sys-Virt for openSUSE:Factory checked in at 2015-05-29 10:46:31 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/perl-Sys-Virt (Old) and /work/SRC/openSUSE:Factory/.perl-Sys-Virt.new (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "perl-Sys-Virt" Changes: -------- --- /work/SRC/openSUSE:Factory/perl-Sys-Virt/perl-Sys-Virt.changes 2015-04-22 01:18:58.000000000 +0200 +++ /work/SRC/openSUSE:Factory/.perl-Sys-Virt.new/perl-Sys-Virt.changes 2015-05-29 10:46:32.000000000 +0200 @@ -1,0 +2,6 @@ +Thu May 21 11:31:26 MDT 2015 - [email protected] + +- Update to 1.2.15 + - Add all new APIs and constants in libvirt 1.2.15 + +------------------------------------------------------------------- Old: ---- Sys-Virt-1.2.14.tar.gz New: ---- Sys-Virt-1.2.15.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ perl-Sys-Virt.spec ++++++ --- /var/tmp/diff_new_pack.DwhIil/_old 2015-05-29 10:46:32.000000000 +0200 +++ /var/tmp/diff_new_pack.DwhIil/_new 2015-05-29 10:46:32.000000000 +0200 @@ -17,7 +17,7 @@ Name: perl-Sys-Virt -Version: 1.2.14 +Version: 1.2.15 Release: 0 %define cpan_name Sys-Virt Summary: Represent and manage a libvirt hypervisor connection ++++++ Sys-Virt-1.2.14.tar.gz -> Sys-Virt-1.2.15.tar.gz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/Changes new/Sys-Virt-1.2.15/Changes --- old/Sys-Virt-1.2.14/Changes 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/Changes 2015-05-05 17:33:07.000000000 +0200 @@ -1,5 +1,13 @@ Revision history for perl module Sys::Virt +1.2.15 2015-05-05 + + - Add support for VIR_DOMAIN_EVENT_ID_DEVICE_ADDED + event callback & constants. + - Add JOB_DOWNTIME_NET constant + - Add JOB_TIME_ELAPSED_NET constant + - Add virDomainAddIOThread and virDomainDelIOThread API bindings + 1.2.14 2015-04-09 - Add VIR_CONNECT_BASELINE_CPU_MIGRATABLE constant diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/HACKING new/Sys-Virt-1.2.15/HACKING --- old/Sys-Virt-1.2.14/HACKING 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/HACKING 2015-05-05 17:33:07.000000000 +0200 @@ -1,10 +1,197 @@ Hacking on libvirt perl ======================= -After each libvirt release: +The libvirt Perl release versions are tied directly to the libvirt C +library release versions. ie Sys::Virt 1.2.10 will require libvirt +version 1.2.10 or newer in order to build. We do not aim to support +conditional compilation against versions of libvirt that are older +than the version of Sys::Virt. - - Look at src/libvirt_public.syms and find any - new APIs introduced - - Look at include/libvirt/virterror.h and find - any new VIR_FROM_XXX and VIR_ERR_XXX constants - - Look for any new constants in libvirt.h.in \ No newline at end of file + +General changes for new APIs +---------------------------- + +Additions to the libvirt C API will require changes to a minimum +of two parts of the Sys::Virt codebase. + + - Virt.xs - this provides the C glue code to access the libvirt C + library APIs and constants from the Perl interpretor. As a general + rule, every new function and header file constant/enum requires an + addition to this file. The exceptions are functions that are only + provided for the benefit of language bindings and not intended for + use by application code. For example the reference counting APIs + don't need exposing to Perl applications + + - lib/ - this directory contains the pure Perl part of the binding. + There are separate files for each core libvirt object type + + - lib/Sys/Virt.pm - mapping for virConnectPtr + - lib/Sys/Virt/Domain.pm - mapping for virDomainPtr + - lib/Sys/Virt/Error.pm - mapping for virErrorPtr + - lib/Sys/Virt/Event.pm - mapping for virEventPtr + - lib/Sys/Virt/Interface.pm - mapping for virInterfacePtr + - lib/Sys/Virt/Network.pm - mapping for virNetworkPtr + - lib/Sys/Virt/NodeDevice.pm - mapping for virNodeDevicePtr + - lib/Sys/Virt/NWFilter.pm - mapping for virNWFilterPtr + - lib/Sys/Virt/Secret.pm - mapping for virSecretPtr + - lib/Sys/Virt/StoragePool.pm - mapping for virStoragePoolPtr + - lib/Sys/Virt/StorageVol.pm - mapping for virStorageVolPtr + - lib/Sys/Virt/Stream.pm - mapping for virStreamPtr + + There is rarely a need to write Perl code in the .pm modules, as + the mapping in the Virt.xs file is usually sufficient. As such + the primary purpose of the .pm modules is to hold the POD inline + documentation. Every function and constants is required to have + full API documentation provided + +There are a number of unit tests available in the t/ directory which +assist in creation of new APIs. + + - t/010-pod-coverage.t - ensures that every Perl method and constant + has POD documentation present + - t/030-api-coverage.t - ensures that every C library method/constant + in the libvirt-api.xml file has corresponding code in the Virt.xs. + Certain functions can be blacklisted in t/030-api-coverage.t as not + needed mapping to Perl. This only runs if TEST_MAINTAINER=1 is set. + - t/*.t - the other files mostly do functional testing against the + test:///default API - if the new function has support in the test + driver, then suitable additions should be made + +If use of the API is not obvious, it is often worth providing a small +example program in the examples/ directory. These examples are also +useful when adding APIs to ensure that they are operating correctly, +if it wasn't possible to unit test them with test:///default. + +Every addition / change to the API must be documented in the Changes +file. + + +New API addition workflow +------------------------- + +When the libvirt C library is changed, the following workflow is an +effective way to update the Perl binding. + + - Build the libvirt C library + + # cd $HOME/src/libvirt + # ./autogen.sh --system + # make + + - Configure & build the Sys::Virt module to build against the just + built libvirt library + + # cd $HOME/src/libvirt-perl + # ../libvirt/run perl Makefile.PL + # ../libvirt/run make + + - Run the test suite to identify which new functions/constants need + handling + + # ../libvirt/run make test TEST_MAINTAINER=1 + + - For each missing item reported in the test suite... + + - Edit Virt.xs to add the C binding + - Edit lib/*.pm to add the POD documentation (and occassionally Perl glue code) + - Edit Changes to document the addition + - Run the test suite (without maintainer mode) to verify POD docs + # ../libvirt/run make test + - Optionally add to one of the t/*.t test cases + - Optionally add demo to examples/ + - Commit the changes to GIT + + +Understanding Virt.xs glue layer +-------------------------------- + +The Perl XS glue (Virt.xs) is a pretty bizarre language, that mostly +looks like C but is actually run through a Perl specific preprocessor +to turn it into real C code. Learning and understanding XS code well +is a really difficult task, but fortunately such knowledge is rarely +required in order to add new APIs to the Perl Sys::Virt code. + +When adding constants just look for the REGISTER_CONSTANT() macro +at the end of Virt.xs. Make sure that the constant is registered against +the correct Sys::Virt::XXXX object namespace - look for the adjacent +'gv_stashpv' calls to see which namespace is currently in effect. + +When adding methods, you must again make sure they are put in the +correct object namespace. For methods, look for the statements +that look like: + + MODULE = Sys::Virt::NWFilter PACKAGE = Sys::Virt::NWFilter + +these indicate the start of a namespace for the object in question. +When implementing the binding for a method, if not already familiar +with XS code, the best technique is to just do cut+paste programming. +Find an existing libvirt API call that has the same kind of API +signature as the new API. Then just copy the XS code for that method +and tweak the parameter names as needed. + +Async event callbacks have a little bit of special handling too. The +callbacks are all implemented as static methods at the very top of +the Virt.XS file. Look for method names like _domain_event_pmsuspend_callback +and just copy the code for an existing callback method that has a similar +set of parameters to the new callback. + +Once the callback is implemented look for the domain_event_register_any() +or network_event_register_any() methods and extend the switch() statement +so that it maps the event ID constant to your new callback. + + +Making new releases +------------------- + +The Sys::Virt releases are hosted on the Perl project CPAN infrastructure +rather than libvirt.org + + 1. Build the new release of libvirt as an RPM and install it on the + local machine. + + 2. Set the release date in the Changes file and commit the change + + 3. Tag the release with a GPG signed tag using vX.Y.Z syntax for + the tag name + + git tag -s -m 'Release 1.2.14' v1.2.14 + + 4. Clone the repository or run 'git clean -x -f -d' to ensure a + 100% pristine state + + 5. Run autobuild.sh to test the full test suite and generate local + RPMs. This results in Sys-Virt-1.2.14.tar.gz file being created + + 6. Take the src.rpm file that was just generated by autobuild.sh + and run a scratch build against Fedora rawhide + + # cd $HOME/src/fedora/perl-Sys-Virt + # fedpkg scratch-build --srpm /path/to/src/rpm/file + + 7. Push the Changes commit and tag to GIT master + + # git push + # git push origin v1.2.14 + +If there is a failure at any step then this must be corrected +as follows + + a. Delete the signed release tag + + git tag -d v1.2.14 + + b. Fix whatever the problem was and update the Changes file + if appropriate + + c. Go to release process step 3 again. + + +Assuming the release has now been made, the Sys-Virt-1.2.14.tar.gz +file should be uploaded to CPAN using https://pause.cpan.org form. +The upload is currently done by Daniel Berrange (username DANBERR). + +Now open the tree for the next release version by editing the files +lib/Sys/Virt.pm, README, Makefile.PL to update the version number +listed. Also edit Changes to add a placeholder entry for the new +release number. Run 'make test' to ensure Changes file is syntax +valid. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/META.yml new/Sys-Virt-1.2.15/META.yml --- old/Sys-Virt-1.2.14/META.yml 2015-04-09 18:36:10.000000000 +0200 +++ new/Sys-Virt-1.2.15/META.yml 2015-05-05 17:33:24.000000000 +0200 @@ -1,7 +1,7 @@ --- #YAML:1.0 name: Sys-Virt abstract: Extension for the libvirt library -version: 1.2.14 +version: 1.2.15 author: - Daniel P. Berrange <[email protected]> license: perl diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/MYMETA.json new/Sys-Virt-1.2.15/MYMETA.json --- old/Sys-Virt-1.2.14/MYMETA.json 2015-04-09 18:36:02.000000000 +0200 +++ new/Sys-Virt-1.2.15/MYMETA.json 2015-05-05 17:33:17.000000000 +0200 @@ -42,5 +42,5 @@ } }, "release_status" : "stable", - "version" : "v1.2.14" + "version" : "v1.2.15" } diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/MYMETA.yml new/Sys-Virt-1.2.15/MYMETA.yml --- old/Sys-Virt-1.2.14/MYMETA.yml 2015-04-09 18:36:02.000000000 +0200 +++ new/Sys-Virt-1.2.15/MYMETA.yml 2015-05-05 17:33:17.000000000 +0200 @@ -24,4 +24,4 @@ Test::Pod::Coverage: '0' Time::HiRes: '0' XML::XPath: '0' -version: v1.2.14 +version: v1.2.15 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/Makefile.PL new/Sys-Virt-1.2.15/Makefile.PL --- old/Sys-Virt-1.2.14/Makefile.PL 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/Makefile.PL 2015-05-05 17:33:07.000000000 +0200 @@ -3,7 +3,7 @@ # See lib/ExtUtils/MakeMaker.pm for details of how to influence # the contents of the Makefile that is written. -my $libvirtver = "1.2.14"; +my $libvirtver = "1.2.15"; my $stat = system "pkg-config --atleast-version=$libvirtver libvirt"; die "cannot run pkg-config to check libvirt version" if $stat == -1; die "libvirt >= $libvirtver is required\n" unless $stat == 0; diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/README new/Sys-Virt-1.2.15/README --- old/Sys-Virt-1.2.14/README 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/README 2015-05-05 17:33:07.000000000 +0200 @@ -7,6 +7,6 @@ The only pre-requisite for this module is libvirt itself. For installation instructions, consult the INSTALL file. -The current minimum required version of libvirt is 1.2.14 +The current minimum required version of libvirt is 1.2.15 -- End diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/Virt.xs new/Sys-Virt-1.2.15/Virt.xs --- old/Sys-Virt-1.2.14/Virt.xs 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/Virt.xs 2015-05-05 17:33:07.000000000 +0200 @@ -858,6 +858,44 @@ static int +_domain_event_device_added_callback(virConnectPtr con, + virDomainPtr dom, + const char *devAlias, + void *opaque) +{ + AV *data = opaque; + SV **self; + SV **cb; + SV *domref; + dSP; + + self = av_fetch(data, 0, 0); + cb = av_fetch(data, 1, 0); + + SvREFCNT_inc(*self); + + ENTER; + SAVETMPS; + + PUSHMARK(SP); + XPUSHs(*self); + domref = sv_newmortal(); + sv_setref_pv(domref, "Sys::Virt::Domain", (void*)dom); + virDomainRef(dom); + XPUSHs(domref); + XPUSHs(sv_2mortal(newSVpv(devAlias, 0))); + PUTBACK; + + call_sv(*cb, G_DISCARD); + + FREETMPS; + LEAVE; + + return 0; +} + + +static int _domain_event_device_removed_callback(virConnectPtr con, virDomainPtr dom, const char *devAlias, @@ -2942,12 +2980,15 @@ case VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE: callback = VIR_DOMAIN_EVENT_CALLBACK(_domain_event_balloonchange_callback); break; + case VIR_DOMAIN_EVENT_ID_DEVICE_ADDED: + callback = VIR_DOMAIN_EVENT_CALLBACK(_domain_event_device_added_callback); + break; case VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED: callback = VIR_DOMAIN_EVENT_CALLBACK(_domain_event_device_removed_callback); break; case VIR_DOMAIN_EVENT_ID_TUNABLE: - callback = VIR_DOMAIN_EVENT_CALLBACK(_domain_event_tunable_callback); - break; + callback = VIR_DOMAIN_EVENT_CALLBACK(_domain_event_tunable_callback); + break; case VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE: callback = VIR_DOMAIN_EVENT_CALLBACK(_domain_event_agent_lifecycle_callback); break; @@ -5059,6 +5100,26 @@ _croak_error(); +void +add_iothread(dom, iothread_id, flags=0) + virDomainPtr dom; + unsigned int iothread_id; + unsigned int flags; + PPCODE: + if (virDomainAddIOThread(dom, iothread_id, flags) < 0) + _croak_error(); + + +void +del_iothread(dom, iothread_id, flags=0) + virDomainPtr dom; + unsigned int iothread_id; + unsigned int flags; + PPCODE: + if (virDomainDelIOThread(dom, iothread_id, flags) < 0) + _croak_error(); + + int num_of_snapshots(dom, flags=0) virDomainPtr dom; @@ -7519,6 +7580,7 @@ REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_DISK_TOTAL, JOB_DISK_TOTAL); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_DISK_BPS, JOB_DISK_BPS); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_DOWNTIME, JOB_DOWNTIME); + REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_DOWNTIME_NET, JOB_DOWNTIME_NET); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_MEMORY_CONSTANT, JOB_MEMORY_CONSTANT); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_MEMORY_NORMAL, JOB_MEMORY_NORMAL); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_MEMORY_NORMAL_BYTES, JOB_MEMORY_NORMAL_BYTES); @@ -7528,6 +7590,7 @@ REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_MEMORY_BPS, JOB_MEMORY_BPS); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_SETUP_TIME, JOB_SETUP_TIME); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_TIME_ELAPSED, JOB_TIME_ELAPSED); + REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_TIME_ELAPSED_NET, JOB_TIME_ELAPSED_NET); REGISTER_CONSTANT_STR(VIR_DOMAIN_JOB_TIME_REMAINING, JOB_TIME_REMAINING); REGISTER_CONSTANT(VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWN, BLOCK_JOB_TYPE_UNKNOWN); @@ -7563,6 +7626,7 @@ REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_PMWAKEUP, EVENT_ID_PMWAKEUP); REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_TRAY_CHANGE, EVENT_ID_TRAY_CHANGE); REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE, EVENT_ID_BALLOON_CHANGE); + REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_DEVICE_ADDED, EVENT_ID_DEVICE_ADDED); REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED, EVENT_ID_DEVICE_REMOVED); REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_TUNABLE, EVENT_ID_TUNABLE); REGISTER_CONSTANT(VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE, EVENT_ID_AGENT_LIFECYCLE); diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/lib/Sys/Virt/Domain.pm new/Sys-Virt-1.2.15/lib/Sys/Virt/Domain.pm --- old/Sys-Virt-1.2.14/lib/Sys/Virt/Domain.pm 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/lib/Sys/Virt/Domain.pm 2015-05-05 17:33:07.000000000 +0200 @@ -1237,6 +1237,18 @@ given by C<$mask>. The C<$mask> is a string representing a bitmask against physical CPUs, 8 cpus per character. +=item $dom->add_iothread($iothread, $flags=0) + +Add a new IOThread by the C<$iothread> value to the guest domain. +The C<$flags> parameter accepts one or more the CONFIG OPTION constants +documented later, and defaults to 0 if omitted. + +=item $dom->del_iothread($iothread, $flags=0) + +Delete an existing IOThread by the C<$iothread> value from the guest domain. +The C<$flags> parameter accepts one or more the CONFIG OPTION constants +documented later, and defaults to 0 if omitted. + =item my @stats = $dom->get_cpu_stats($startCpu, $numCpus, $flags=0) Requests the guests host physical CPU usage statistics, starting @@ -1334,6 +1346,12 @@ The elapsed time in milliseconds +=item Sys::Virt::Domain::JOB_TIME_ELAPSED_NET + +Time in miliseconds since the beginning of the migration job NOT +including the time required to transfer control flow from the +source host to the destination host. + =item Sys::Virt::Domain::JOB_TIME_REMAINING The expected remaining time in milliseconds. Only set if the @@ -1423,6 +1441,12 @@ The number of milliseconds of downtime expected during migration switchover. +=item Sys::Virt::Domain::JOB_DOWNTIME_NET + +Real measured downtime (ms) NOT including the time required to +transfer control flow from the source host to the destination +host. + =item Sys::Virt::Domain::JOB_SETUP_TIME The number of milliseconds of time doing setup of the job @@ -2791,6 +2815,10 @@ Balloon target changes +=item Sys::Virt::Domain::EVENT_ID_DEVICE_ADDED + +Asynchronous guest device addition + =item Sys::Virt::Domain::EVENT_ID_DEVICE_REMOVED Asynchronous guest device removal diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/lib/Sys/Virt.pm new/Sys-Virt-1.2.15/lib/Sys/Virt.pm --- old/Sys-Virt-1.2.14/lib/Sys/Virt.pm 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/lib/Sys/Virt.pm 2015-05-05 17:33:07.000000000 +0200 @@ -78,7 +78,7 @@ use Sys::Virt::DomainSnapshot; use Sys::Virt::Stream; -our $VERSION = '1.2.14'; +our $VERSION = '1.2.15'; require XSLoader; XSLoader::load('Sys::Virt', $VERSION); diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/perl-Sys-Virt.spec new/Sys-Virt-1.2.15/perl-Sys-Virt.spec --- old/Sys-Virt-1.2.14/perl-Sys-Virt.spec 2015-04-09 18:36:10.000000000 +0200 +++ new/Sys-Virt-1.2.15/perl-Sys-Virt.spec 2015-05-05 17:33:24.000000000 +0200 @@ -1,7 +1,7 @@ # Automatically generated by perl-Sys-Virt.spec.PL Name: perl-Sys-Virt -Version: 1.2.14 +Version: 1.2.15 Release: 1%{?dist}%{?extra_release} Summary: Represent and manage a libvirt hypervisor connection License: GPLv2+ or Artistic diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/Sys-Virt-1.2.14/t/030-api-coverage.t new/Sys-Virt-1.2.15/t/030-api-coverage.t --- old/Sys-Virt-1.2.14/t/030-api-coverage.t 2015-04-09 18:35:58.000000000 +0200 +++ new/Sys-Virt-1.2.15/t/030-api-coverage.t 2015-05-05 17:33:07.000000000 +0200 @@ -87,6 +87,7 @@ virConnectDomainEventPMWakeupCallback virConnectDomainEventTrayChangeCallback virConnectDomainEventBalloonChangeCallback +virConnectDomainEventDeviceAddedCallback virConnectDomainEventDeviceRemovedCallback virConnectDomainEventTunableCallback virConnectDomainEventAgentLifecycleCallback
