---
name: "sb2-session"
section: "1"
platform: "linux"
package: "scratchbox2"
version: "2.2.4-1debian1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/sb2-session"
---

# sb2-session(1)

manage scratchbox2 sessions

## 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)](/sb2/1.md)

## AUTHOR

```
Mika Westerberg
```