NAME

       sb2-session - manage scratchbox2 sessions

SYNOPSIS

       sb2-session [COMMAND [PARAMS]]

DESCRIPTION

       sb2-session  is  used  to  create  attachable  scratchbox2  sessions.  You can save session even when you
       haven't done '-S session' during sb2 startup.

       Note that you can give parameters to attach command which are passed verbatim to sb2. If  there  is  only
       one session to attach, it is selected automatically.

       If no command is given, help text is printed.

COMMANDS

       help   shows help text

       save   saves current session

       list   lists detached sb2 sessions

       delete SESSION
              deletes given session

       attach [SESSION [PARAMS]]
              attaches to a given session

       setenv VARIABLE VALUE
              store a value for an environment variable

       showenv
              show stored environment variables

EXAMPLES

       Basic usage is:

           [SB2 .. ] $ sb2-session save  # save session
           [SB2 .. ] $ ^D                # exit

       Later we can then attach to this session:

           % sb2-session attach

       If there are more than one saved session, then:

           % sb2-session list
           session.XXXX    TARGET_ARM      My Comment
           session.YYYY    TARGET_ARM      My Comment 2
           session.ZZZZ    TARGET_MIPS
           % sb2-session attach session.YYYY

       Here we pass '-eR' to sb2 and we only have one saved session:

            % sb2-session attach -- -eR

       '--' marks end of parameter list for sb2-session.

       setenv  VARIABLE  VALUE  can  be  used to add environment variables, that will become active when a saved
       session is later taken into use (either by sb2-session attach or by sb2 -J).

       setenv VARIABLE VALUE does not change environment of sessions that are already active.

       showenv lists environment variable settings which have been stored with  this  tool.  It  does  not  show
       environment variables from other sources.

SEE ALSO

       sb2(1)

AUTHOR

       Mika Westerberg

2.2                                             21 December 2010                                  sb2-session(1)