/usr/share/doc/libisoburn-doc/html/comments_source.html is in libisoburn-doc 1.3.2-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.8"/>
<title>libisoburn: libisoburn-1.3.2/doc/comments Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libisoburn
 <span id="projectnumber">1.3.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.8 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_df3b493efdba9879ede8cfe9baebdcb1.html">libisoburn-1.3.2</a></li><li class="navelem"><a class="el" href="dir_ce6b99267613a9a20a4dc217c2847b3d.html">doc</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">comments</div> </div>
</div><!--header-->
<div class="contents">
<a href="comments.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> /**</div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span>  @author Mario Danic, Vreixo Formoso, Thomas Schmitt</div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> </div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span>  @mainpage Libisoburn Documentation Index</div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span>  @section intro Introduction</div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> </div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> Libburnia is an open-source project for reading, mastering and writing</div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> optical discs. This page is about its capability to read, manipulate, and</div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> write ISO 9660 filesystems with Rock Ridge extensions. Media can be optical</div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> media or filesystem objects.</div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> </div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> Our scope is currently Linux 2.4 and 2.6, or FreeBSD, or OpenSolaris.</div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> </div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> libisoburn is an add-on to libburn and libisofs which coordinates both and</div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> also allows to grow ISO-9660 filesystem images on multi-session media as well</div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> as on overwriteable media via the same API.</div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> All media peculiarities are handled automatically.</div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> </div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> xorriso is an application of all three libraries which creates, loads,</div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions.</div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> Manipulation is not only adding or overwriting of files but also deletion,</div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> renaming, and attribute changing. An incremental backup feature is provided.</div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> The xorriso features are accessible via built-in command interpreters and</div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> via a C language API.</div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> SONAME:</div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> libisoburn.so.1 (since 0.1.0, February 2008).</div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  @section using Using the libraries</div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> Our build system is based on autotools.</div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> User experience tells us that you will need at least autotools version 1.7.</div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> To build libisoburn go into its toplevel directory and execute:</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> - ./bootstrap (needed if you downloaded from SVN)</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> - ./configure</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> </div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> - make</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> </div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> To make the library and the xorriso application accessible for running resp.</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> software development:</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> - make install</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> </div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> </div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> For direct use as command line tool use the xorriso binary which among many</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> other features provides a mkisofs emulation via command "-as mkisofs".</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> See man page xorriso/xorriso.1 or GNU info document xorriso/xorriso.info.</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> </div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> If you want to link an own application with libisoburn, you have</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> two alternative APIs for choice:</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> </div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> - libisoburn, together with libburn and libisofs.</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> - xorriso, a complete representation of xorriso command line options.</div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  It encapsulates the three lower level libraries.</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  Calls of both API families shall not be mixed.</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> </div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> For a description of the lbisoburn API read libisoburn/libisoburn.h</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> See file README for download and installation of a release tarball.</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> You will also have to install and understand the two libraries of the </div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> Libburnia project which provide fundamental services:</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> libburn is the library by which preformatted data get onto optical media.</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> See libburn/libburn.h for its API description.</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> libisofs is the library to handle ISO 9660 filesystems with Rock Ridge </div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> extensions. Its API is described in libisofs/libisofs.h .</div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> </div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> For xorriso features see its man page xorriso/xorriso.1 or</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> its GNU info document xorriso/xorriso.info.</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> For the corresponding C language API see libisoburn/xorriso.h (resp.</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> xorriso/xorriso.h in the build directory).</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> The implementation this API is part of libisoburn.</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> The xorriso command line tool gets installed as dynamically linked</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> binary together with libisoburn.</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> There is also a statically linked release named GNU xorriso.</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> See xorriso/README_gnu_xorriso for its download and installation.</div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> </div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> */</div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Aug 30 2014 00:16:21 for libisoburn by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.8
</small></address>
</body>
</html>
|