sb2-session(1)

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