WibuKey Help

Contents

  WibuKey

User Tool wku

     
 

WibuKey - A protection system

WibuBox Versions

RunTime Installation

WibuBox Remote Programming

Configuration with WkConfig

User Tool wku

WkLAN Network Server

Configurations

WibuKey FAQ

General

wku is the universal WibuKey console application for the WibuKey user. The program is available as wkuLin for Linux and as wkuMacX for Mac OS X. A global symbolical link to wku also exists.

wku - Parameters

wku has a lot of features, which are defined by the following arguments:

  • If the program is called without arguments it lists all found WibuKey ports and the number of connected WibuBoxes.

  • With the wku LIST command, the content of one or more WibuBoxes at one or more ports is displayed.

  • With the wku TEST command, the encryption functionality of all or of the specified WibuBoxes is checked in greater detail by a specific number of checks.

  • With the wku DATA command, the user can list and modify User Data entries in the WibuBox.

  • With the wku REMOTE command, the user can create a remote programming context information file or apply a remote programming update file to a WibuBox to change its content.
    See also Remote Programming.

  • wku NETWORK searches for WkLAN servers on the local network.

For more details about the use of wku see the installed man page or the application help or by the subcommand specific application help.

 man wku
or
wku -h
or
wku LIST -h

wku - Remote Programming

wku can create a remote context file for one or more connected WibuBoxes via the REMOTE GET command:

 wku REMOTE GET ALL TO x.rtc

writes the content of all connected WibuBoxes to the x.rtc file. To minimize the size of this file, a user can select the ports or the connected WibuBoxes of which content should be stored. The port and WibuBox selection is done like other wku commands:

 wku REMOTE USB:1 GET ALL TO x.rtc 

writes the content of the first WibuBox at USB to the x.rtc file.

A further reduction of the remote programming context file size can be reached by specifying the number of needed entries. This is done by one or more numbers in the range of 1 to 10 instead of the ALL keyword.

 wku REMOTE USB:2 GET 1,5 TO x.rtc

writes only the content of entries 1 and 5 of the second WibuBox at USB to the remote context file.

UTo add a new entry, the programmer on the other side of the remote programming process only needs a list of empty entries in the WibuBox. This can be achieved by the EMPTY keyword:

 wku REMOTE GET EMPTY TO x.rtc

The file (for example x.rtc) can now be sent in any form (floppy disk, email, printed as letter or facsimile or verbal via phone) to the software producer. Here the file is used for modifications of the WibuBox.

The software producer sends a remote programming update file back to the WibuBox user. This new file contains commands to modify the specific content of the WibuBox. To execute the WibuBox programming commands, wku is also used, which is explained now.

To transfer remote programming update information into a connected WibuBox, the SET command of wku is used:

 wku REMOTE SET FROM x.rtu

searches at all ports for WibuBoxes matching the remote update data. An optional list of WibuKey ports or specific WibuBoxes can limit the update process to a subset of connected WibuBoxes.

wku - Network

With the AT command all other wku commands can be redirected to other computers via network. To do this, wku uses the WkLAN network protocol. An example to list all WibuBox entries on hostname:

 wku AT hostname LIST