NAME

       session-migration - Migrate in user session settings.

SYNOPSIS

       session-migration [options]

DESCRIPTION

       The  session-migration  program can be used to migrate in-session user data when a program
       is evolving its configuration, or needing to have files moved and so on. This  program  is
       generally  autostarted  at  the  very  beginning  of  the  session  and integrates caching
       capabilities.

       The general usage is to ship an executable file in XDG_DATA_DIR/session-migration/scripts.
       This  one  will  be executed the next time the user log into the session. It will executes
       all executable files there in ascii order, one after another.

       Even if the program tries to cache some timestamp and scripts to not  be  launched  twiced
       (they are skipped on subsequent runs), the executables file should be idempotent.

OPTIONS

       --dry-run
              This  parameter  enables to run the session-migration tool without really launching
              the scripts and marking them are migrated. It's generally used with  --verbose  for
              debugging purposes.

       --file filename
              This  parameter,  followed  by  a path or filename, tells sesions-migration to only
              consider that script file and ignoring XDG_DATA_DIR. It  won't  log  as  well  this
              special file as being migrated.

       --help Display a quick command help.

       --verbose
              Show  a  lot  of  verbose  information.  It  can  be  used  by  the  user  to debug
              configuration issues;

                                           12 July 2012                      session-migration(1)