sb2-session(1)						       sb2-session man page						    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

2.2								 21 December 2010						    sb2-session(1)