SDK Resources > Redirection Library > Linux Sample Application

Linux Sample Application

The SDK includes the following Linux sample program (located at: <SDK_root>\Linux\Intel_AMT\Samples\Redirection).

   Redirection Sample – A sample that demonstrates redirection library capabilities.

note-icon Note:

When working in Linux, Redirection is supported with physical disks only.  There is no Linux Redirection support for iso or img files.

Trying to push large quantities of SOL data over TLS can result in the corruption of the data’s integrity.



Redirection Sample Functionality Overview

When running the application from a command shell, the user will be presented with a list of all available clients that are managed by the redirection library, as well as a menu of available options. By selecting options from the menu, the user will be able to add clients to and delete clients from the console. Selecting a specific client from the list of available clients will display a menu with available options for the client, such as opening/closing SOL and IDE-R sessions.

The imrcli application provides only a basic redirection library example. Most parameters (like session timeout values) are hard-coded in the application.

Linux Sample Project Tree Overview

The sample application files are placed under the RedirectionSDK folder.

Significant files in this folder:

   imrcli.cpp – The source code of the sample application.

   Makefile – The Makefile for compiling the sample application, using the ‘make’ command.

   MC.ini – Sample INI file passed to the Redirection Library at startup.


The SOL functionality is demonstrated by redirecting text from/to the standard input/output. While an SOL session is open, all text from the standard input (keyboard) is redirected to the Intel AMT client (Ctrl-D is used to terminate the SOL session). This means that while an SOL session is open, it is impossible to issue other commands to the imrcli sample application, such as opening an IDE-R session. To have both an SOL session and an IDE-R session open simultaneously, open the IDE-R session before opening the SOL session.

When an SOL session is open, text from the keyboard is sent to the remote Intel AMT client without echoing it locally to the standard output. The characters will only be displayed if the Intel AMT client echoes them back to the console. This behavior can be changed by modifying the imrcli sample application’s source code.


When opening an IDE-R session, the sample application will request the names of the floppy and CD devices that are to be redirected (these devices are usually /dev/fd0 and /dev/cdrom, respectively). To redirect these devices, the user must make sure that they are mounted to a file system, using the ‘mount’ command (e.g. /dev/cdrom is usually mounted to /mnt/cdrom).

To change the floppy or CD during an IDE-R session, the user must first unmount the device’s file system (using the ‘umount’ command), and then mount the file system again after the media has been changed.


Changing floppy diskettes during an IDE-R session without first unmounting the original floppy’s file system may cause data corruption of the new floppy if it is not write-protected.

Any new files written to a floppy locally on the management console platform while it is being read by the Intel AMT device will not be detected by the device unless the disk is removed and re-inserted or the platform with Intel AMT is power cycled.

Copyright © 2006-2013, Intel Corporation. All rights reserved.