git.maemo.org Git - urpo/blob - www/help.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html><head>
   3
   4
   5   <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>URPO Utility for Remote Printing</title></head><body>
   6 <table style="text-align: left; width: 640px; margin-left: auto; margin-right: auto;" border="0" cellpadding="2" cellspacing="2">
   7
   8   <tbody>
   9     <tr align="center">
  10       <td style="vertical-align: middle; width: 484px; background-color: rgb(204, 204, 255); text-align: center;"><span style="font-family: Helvetica,Arial,sans-serif;"></span><img style="width: 48px; height: 48px;" alt="" src="urpo.png" align="middle">&nbsp;
  11       <big><span style="font-family: Helvetica,Arial,sans-serif;">URPO
  12 Remote Printing Utility for Maemo</span></big> <br>
  13       </td>
  14     </tr>
  15     <tr align="center">
  16       <td style="vertical-align: top; width: 484px; background-color: rgb(153, 153, 255);"><span style="font-family: Helvetica,Arial,sans-serif;"><a href="index.html">Home</a>&nbsp;
  17 |&nbsp;&nbsp; <a href="https://garage.maemo.org/frs/?group_id=1697">Download</a>&nbsp;
  18 |&nbsp;&nbsp; <a href="screenshot.html">Screenshots</a>&nbsp; |&nbsp;&nbsp; <a href="help.html">Help</a>&nbsp;&nbsp;
  19 |&nbsp;&nbsp; <a href="apidoc/html/index.html">Api Documentation</a>&nbsp; |&nbsp; <a href="https://garage.maemo.org/projects/urpo/">Project page</a></span><br>
  20       </td>
  21     </tr>
  22     <tr>
  23       <td style="vertical-align: top;"><br>
  24       <span style="font-family: Helvetica,Arial,sans-serif;"></span>
  25       <h1>URPO 0.9</h1>
  26
  27
  28
  29
  30       <a href="#features">Features</a>&nbsp;
  31  <a href="#requiremets">Requirements</a>&nbsp;
  32       <a href="#keygen">Generating
  33  SSH-keys</a>&nbsp; <a href="#Settings">Settings</a>&nbsp;
  34       <a href="#Printing">Printing</a>&nbsp;
  35  <a href="#Debug">Debug</a><br>
  36
  37
  38       <br>
  39
  40
  41 Unix Remote Printing Operation<br>
  42
  43
  44 A Program for printing files via a server<br>
  45
  46
  47 � Arto Hyv�ttinen 2010<br>
  48
  49
  50       <br>
  51
  52
  53 URPO is free to use according to GPL 3. No guarantees. See <a href="http://www.gnu.org/licenses/gpl.html">the lisence</a>.<br>
  54
  55
  56       <h3><a name="features"></a>Features<br>
  57       </h3>
  58
  59
  60 With URPO you can print files to a printer attached to a
  61 linux/unix-computer. URPO uses the<a href="http://www.cups.org/"> CUPS</a>-system
  62 on
  63  the computer for printing. It is designed for use on a Maemo 5
  64 device.<br>
  65
  66
  67       <br>
  68
  69
  70 You can print files in all formats supported by CUPS:<br>
  71
  72
  73       <ul>
  74 <li>Text files</li><li>PDF</li><li>PostScript</li><li>HP-GL/2</li><li>Image files: BMP, GIF, JPG, PhotoCD, PIX, PNG, PNM, TIFF</li>
  75       </ul>
  76
  77
  78       <h3><a name="requiremets"></a>Requirements<br>
  79       </h3>
  80
  81
  82 You need an <a href="http://www.openssh.org/"><span style="font-weight: bold;">openssh</span>-</a>program on your maemo
  83 device.<br>
  84
  85
  86 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.
  87 CUPS (Common Unix Printing System) is a printing server, installed by
  88 default in several linux distributions. The ssh server is needed to
  89 safely connect to the computer. The port 22 needs to be opened from the
  90 computer's firewall. There is no need to open a port for cups.<br>
  91
  92
  93       <h3><a name="keygen"></a>Generating SSH-keys</h3>
  94
  95
  96 A SSH key pair is needed to identify the user. The key pair is created
  97 in the maemo device:<br>
  98
  99
 100       <code>ssh-keygen -t rsa</code><br>
 101
 102
 103 The password is left empty. Remember where you have saved the keys! You
 104 cannot save them in the MyDocs folder, since the private key must not
 105 be accessible to others than the user.<br>
 106
 107
 108       <br>
 109
 110
 111 The access rights of the file need to be set:<br>
 112
 113
 114       <code>chmod 600 ~/.ssh/id_urpo</code><br>
 115
 116
 117       <br>
 118
 119
 120 The public key is added to the server (computer) in the home
 121 folder's&nbsp; .ssh folder's file&nbsp; authorized_keys . You can use
 122 ssh for transferring it:<br>
 123
 124
 125       <code>cat ~/.ssh/id_urpo.pub | ssh user@computer 'cat &gt;&gt;
 126 ~./ssh/authorized_keys'</code><br>
 127
 128
 129       <br>
 130
 131
 132 The location of the private key is set in the settings of URPO.<br>
 133
 134
 135       <h3><a name="Settings"></a> Settings<br>
 136       </h3>
 137
 138
 139 When used for the first time URPO asks for settings. You can access
 140 these settings later by choosing "Settings"&nbsp; from the menu. <span style="font-weight: bold;"></span><br>
 141
 142
 143       <span style="font-weight: bold;">Host name or ip address:</span> The
 144 computer's&nbsp; (server's) ip address, or its name if the device can
 145 find it by name.<br>
 146
 147
 148       <span style="font-weight: bold;">Username: </span>The user account on
 149 the server .<br>
 150
 151
 152       <span style="font-weight: bold;">Identity file</span>: The private
 153 ssh-key.<br>
 154
 155
 156       <h3><a name="Printing"></a>Printing</h3>
 157
 158
 159 Choose the file to be printed (<span style="font-weight: bold;">Browse</span>).<br>
 160
 161
 162 Choose the printer.<br>
 163
 164
 165 If desired, limit what pages are to be printed, e.g 1,2 or 3-6 or 1,5-7
 166 .<br>
 167
 168
 169 You can choose 1, 2 or 4 pages to be printed per sheet.<br>
 170
 171
 172 You can print 1-99 copies.<br>
 173
 174
 175 Printing is started with the <span style="font-weight: bold;">Print</span>-button.<br>
 176
 177
 178       <br>
 179
 180
 181       <h3><a name="Debug"></a>Debug-window</h3>
 182
 183
 184 When<span style="font-weight: bold;"> "Debug</span>" is chosen from the
 185 menu, a debug window opens. Information useful in solving problems,
 186 such as the commands given to server trough ssh and their output, is
 187 printed on that window. <br>
 188       </td>
 189     </tr>
 190     <tr align="center">
 191       <td style="vertical-align: top;"><br>
 192       </td>
 193     </tr>
 194     <tr>
 195       <td style="vertical-align: top; width: 484px; background-color: rgb(204, 204, 255);">�
 196 Arto Hyv�ttinen 2010. Urpo is free software under <a href="http://www.gnu.org/licenses/gpl.html" target="_blank">GNU
 197 General Public License 3</a>.<br>
 198       </td>
 199     </tr>
 200   </tbody>
 201 </table>
 202
 203 <br>
 204
 205 <br>
 206
 207 <br>
 208
 209 </body></html>