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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html><head>
   3
   4   <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
   5   <title>URPO help</title>
   6
   7
   8 </head><body>
   9 <h1>URPO 0.9</h1>
  10
  11 <br>
  12
  13 <a href="#features">Features</a>&nbsp; <a href="#requiremets">Requirements</a>&nbsp;
  14 <a href="#keygen">Generating SSH-keys</a>&nbsp; <a href="#Settings">Settings</a>&nbsp;
  15 <a href="#Printing">Printing</a>&nbsp; <a href="#Debug">Debug</a><br>
  16
  17 <br>
  18
  19 Unix Remote Printing Operation<br>
  20
  21 A Program for printing files via a server<br>
  22
  23 © Arto Hyvättinen 2010<br>
  24
  25 <br>
  26
  27 URPO is free to use according to GPL 3. No guarantees. See <a href="gpl.html">the lisence</a>.<br>
  28
  29 <h3><a name="features"></a>Features<br>
  30 </h3>
  31
  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
  35 device.<br>
  36
  37 <br>
  38
  39 You can print files in all formats supported by CUPS:<br>
  40
  41 <ul>
  42
  43   <li>Text files</li>
  44   <li>PDF</li>
  45   <li>PostScript</li>
  46   <li>HP-GL/2</li>
  47   <li>Image files: BMP, GIF, JPG, PhotoCD, PIX, PNG, PNM, TIFF</li>
  48 </ul>
  49
  50 <h3><a name="requiremets"></a>Requirements<br>
  51 </h3>
  52
  53 You need an <a href="http://www.openssh.org/"><span style="font-weight: bold;">openssh</span>-</a>program on your maemo
  54 device.<br>
  55
  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>
  61
  62 <h3><a name="keygen"></a>Generating SSH-keys</h3>
  63
  64 A SSH key pair is needed to identify the user. The key pair is created
  65 in the maemo device:<br>
  66
  67 <code>ssh-keygen -t rsa</code><br>
  68
  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>
  72
  73 <br>
  74
  75 The access rights of the file need to be set:<br>
  76
  77 <code>chmod 600 ~/.ssh/id_urpo</code><br>
  78
  79 <br>
  80
  81 The public key is added to the server (computer) in the home
  82 folder's&nbsp; .ssh folder's file&nbsp; authorized_keys . You can use
  83 ssh for transferring it:<br>
  84
  85 <code>cat ~/.ssh/id_urpo | ssh user@computer 'cat &gt;&gt;
  86 ~./ssh/authorized_keys'</code><br>
  87
  88 <br>
  89
  90 The location of the private key is set in the settings of URPO.<br>
  91
  92 <h3><a name="Settings"></a> Settings<br>
  93 </h3>
  94
  95 When used for the first time URPO asks for settings. You can access
  96 these settings later by choosing "Settings"&nbsp; from the menu. <span style="font-weight: bold;"></span><br>
  97
  98 <span style="font-weight: bold;">Host name or ip address:</span> The
  99 computer's&nbsp; (server's) ip address, or its name if the device can
 100 find it by name.<br>
 101
 102 <span style="font-weight: bold;">Username: </span>The user account on
 103 the server .<br>
 104
 105 <span style="font-weight: bold;">Identity file</span>: The private
 106 ssh-key.<br>
 107
 108 <h3><a name="Printing"></a>Printing</h3>
 109
 110 Choose the file to be printed (<span style="font-weight: bold;">Browse</span>).<br>
 111
 112 Choose the printer.<br>
 113
 114 If desired, limit what pages are to be printed, e.g 1,2 or 3-6 or 1,5-7
 115 .<br>
 116
 117 You can choose 1, 2 or 4 pages to be printed per sheet.<br>
 118
 119 You can print 1-99 copies.<br>
 120
 121 Printing is started with the <span style="font-weight: bold;">Print</span>-button.<br>
 122
 123 <br>
 124
 125 <h3><a name="Debug"></a>Debug-window</h3>
 126
 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>
 131
 132 <br>
 133
 134 </body></html>