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