1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
5 <title>URPO help</title>
13 <a href="#features">Features</a> <a href="#requiremets">Requirements</a>
14 <a href="#keygen">Generating SSH-keys</a> <a href="#Settings">Settings</a>
15 <a href="#Printing">Printing</a> <a href="#Debug">Debug</a><br>
19 Unix Remote Printing Operation<br>
21 A Program for printing files via a server<br>
23 © Arto Hyvättinen 2010<br>
27 URPO is free to use according to GPL 3. No guarantees. See <a href="gpl.html">the lisence</a>.<br>
29 <h3><a name="features"></a>Features<br>
32 With URPO you can print files to a printer attached to a
33 linux/unix-computer. URPO uses the<a href="http://www.cups.org/"> CUPS</a>-system
34 on the computer for printing. It is designed for use on a Maemo 5
39 You can print files in all formats supported by CUPS:<br>
47 <li>Image files: BMP, GIF, JPG, PhotoCD, PIX, PNG, PNM, TIFF</li>
50 <h3><a name="requiremets"></a>Requirements<br>
53 You need an <a href="http://www.openssh.org/"><span style="font-weight: bold;">openssh</span>-</a>program on your maemo
56 On the computer to which the printer is attached to, you need the <span style="font-weight: bold;">cups</span> and <span style="font-weight: bold;">ssh</span>-servers.
57 CUPS (Common Unix Printing System) is a printing server, installed by
58 default in several linux distributions. The ssh server is needed to
59 safely connect to the computer. The port 22 needs to be opened from the
60 computer's firewall. There is no need to open a port for cups.<br>
62 <h3><a name="keygen"></a>Generating SSH-keys</h3>
64 A SSH key pair is needed to identify the user. The key pair is created
65 in the maemo device:<br>
67 <code>ssh-keygen -t rsa</code><br>
69 The password is left empty. Remember where you have saved the keys! You
70 cannot save them in the MyDocs folder, since the private key must not
71 be accessible to others than the user.<br>
75 The access rights of the file need to be set:<br>
77 <code>chmod 600 ~/.ssh/id_urpo</code><br>
81 The public key is added to the server (computer) in the home
82 folder's .ssh folder's file authorized_keys . You can use
83 ssh for transferring it:<br>
85 <code>cat ~/.ssh/id_urpo | ssh user@computer 'cat >>
86 ~./ssh/authorized_keys'</code><br>
90 The location of the private key is set in the settings of URPO.<br>
92 <h3><a name="Settings"></a> Settings<br>
95 When used for the first time URPO asks for settings. You can access
96 these settings later by choosing "Settings" from the menu. <span style="font-weight: bold;"></span><br>
98 <span style="font-weight: bold;">Host name or ip address:</span> The
99 computer's (server's) ip address, or its name if the device can
102 <span style="font-weight: bold;">Username: </span>The user account on
105 <span style="font-weight: bold;">Identity file</span>: The private
108 <h3><a name="Printing"></a>Printing</h3>
110 Choose the file to be printed (<span style="font-weight: bold;">Browse</span>).<br>
112 Choose the printer.<br>
114 If desired, limit what pages are to be printed, e.g 1,2 or 3-6 or 1,5-7
117 You can choose 1, 2 or 4 pages to be printed per sheet.<br>
119 You can print 1-99 copies.<br>
121 Printing is started with the <span style="font-weight: bold;">Print</span>-button.<br>
125 <h3><a name="Debug"></a>Debug-window</h3>
127 When<span style="font-weight: bold;"> "Debug</span>" is chosen from the
128 menu, a debug window opens. Information useful in solving problems,
129 such as the commands given to server trough ssh and their output, is
130 printed on that window. <br>