SDB Commands

The following table lists the commands available for the Smart Development Bridge (SDB).

Table: SDB commands
Command Description
sdb devices List all connected devices.
sdb connect <host>[:<port>] Connect to a device through TCP/IP.
sdb disconnect <host>[:<port>] Disconnect from a TCP/IP device.

Port 26101 is used by default if no port number is specified. Using this command with no additional arguments disconnects from all connected TCP/IP devices.

sdb push <local> <remote> [-with-utf8] Copy a file or directory recursively to the device's data file.

The <local> and <remote> parameters refer to the paths to the target files or directories on the development machine (local) and the device instance (remote). The following command shows an example:

The [-with-utf8] parameter creates the remote file with the UTF-8 character encoding.

$ sdb push data.txt /opt/apps/org.tizen.hellotizen/data/data.txt
sdb pull <remote> [<local>] Copy a file or directory recursively from the device's data file.

The <remote> and <local> parameters refer to the paths to the target files or directories on the device instance (remote) and the development machine (local). The following command shows an example:

$ sdb pull /opt/apps/org.tizen.hellotizen/data/data.txt data.txt
sdb shell Run a remote shell interactively by dropping into a remote shell on an Emulator or device instance.

To exit the remote shell, press Ctrl+D or use the exit command to end the shell session.

sdb shell <command> Run a remote shell command without entering the SDB remote shell on the device. The following commands are available:

ls, rm, mv, cd, mkdir, cp, touch, echo, tar, grep, cat, chmod, rpm, find, uname, netstat, and killall

sdb dlog [option] [<filter-spec>] View and follow the content of the device log buffers.

To view the log output in your development computer or from a remote SDB shell, use the sdb dlog or dlogutil command, respectively.

The [<filter-spec>] parameter defines the tag of interest (the system component from which the message originates) and the minimum level of priority to report for that tag. The format is tag:priority, and multiple filters must be separated with a space. The available priorities (from lowest to highest) are V (Verbose), D (Debug), I (Info), W (Warning), E (Error), and F (Fatal).

For example, to view all log messages of the info priority in addition to the MyApp tag messages of the debug priority, use the following command:

$ sdb dlog MyApp:D *:E

For more information about the command options, see Controlling Log Output.

sdb install <path_to_tpk>

Push the tpk package file to the device and install it.

The <path_to_tpk> parameter defines to the path to the tpk file. The following command shows an example:

$ sdb install /home/tizen/ko983dw33q-1.0.0-i386.tpk
sdb uninstall <pkg_id>

Uninstall the application from the device.

The <pkg_id> is a unique 10-digit identifier for the application. The following command shows an example:

$ sdb uninstall ko983dw33q
sdb forward <local> <remote> Set up arbitrary port forwarding of requests from a specific host port to a different port on a device instance.

The format for the <local> and <remote> parameters is tcp:<port>. The following example shows how to forward requests from host port 26102 to device port 9999:

$ sdb forward tcp:26102 tcp:9999

After setting up port forwarding, development tools between the device and host can work remotely. For example, gdb in a host/gdbserver in a device, and gdbserver in a device open with the tcp:9999 port:

$ sdb shell gdbserver:9999 hellotizen

gdb in a host connects to localhost:26102

$ gdb hellotizen ... (gdb) target remote localhost:26102
sdb help Show the help message.
sdb version Show the version number.
sdb start-server Start the server if it is not running.
sdb kill-server Stop the server if it is running.
sdb get-state Print the target device connection status: device of offline.
sdb get-serialno Print the serial number of the target device.
sdb status-window Continuously print the connection status for a specified device.
sdb root <on|off> Switch between the root and developer account mode.

The on value sets the root mode and the off value sets the developer account mode.

Where to Go Next