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