source: postlfs/filesystems/sshfs.xml@ 2e0d6b9

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 2e0d6b9 was 2e0d6b9, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update sshfs instructions fo rmeson/ninja.
Tags and cleanup.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19847 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 5.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY sshfs-download-http
8 "https://github.com/libfuse/sshfs/releases/download/sshfs-&sshfs-version;/sshfs-&sshfs-version;.tar.xz">
9 <!ENTITY sshfs-download-ftp " ">
10 <!ENTITY sshfs-md5sum "f261fe7ec77adc3a53f2116f3b8cb8ab">
11 <!ENTITY sshfs-size "48 KB">
12 <!ENTITY sshfs-buildsize "1.5 MB">
13 <!ENTITY sshfs-time "less than 0.1 SBU">
14]>
15
16<sect1 id="sshfs" xreflabel="sshfs-&sshfs-version;">
17 <?dbhtml filename="sshfs.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy: renodr $</othername>
21 <date>$Date: 2016-08-27 23:14:16 +0200 (sam. 27 août 2016) $</date>
22 </sect1info>
23
24 <title>sshfs-&sshfs-version;</title>
25
26 <indexterm zone="sshfs">
27 <primary sortas="a-sshfs">sshfs</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Sshfs</title>
32
33 <para>
34 The <application>Sshfs</application> package contains a filesystem
35 client based on the SSH File Transfer Protocol. This is useful for
36 mounting a remote computer that you have ssh access to as a local
37 filesystem. This allows you to drag and drop files or run shell commands
38 on the remote files as if they were on your local computer.
39 </para>
40
41 &lfs82_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&sshfs-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&sshfs-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &sshfs-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &sshfs-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &sshfs-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &sshfs-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Sshfs Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="fuse3"/>,
82 <xref linkend="glib2"/>, and
83 <xref linkend="openssh"/>.
84 </para>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional">
88 <xref linkend="docutils"/> (required to build the man page)
89 </para>
90
91 <para condition="html" role="usernotes">
92 User Notes: <ulink url="&blfs-wiki;/sshfs"/>
93 </para>
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of Sshfs</title>
98
99 <para>
100 If you are building on i686, <application>sshfs</application> needs
101 an extra CFLAGS setting to be defined. This prevents an integer
102 overflow. To do this, run the following command:
103 </para>
104
105<screen><userinput>if [ $(uname -m) = "i686" ]; then
106 export CFLAGS+="-D_FILE_OFFSET_BITS=64";
107fi</userinput></screen>
108
109 <para>
110 Install <application>Sshfs</application> by running the following
111 commands:
112 </para>
113
114 <screen><userinput>mkdir build &amp;&amp;
115cd build &amp;&amp;
116
117meson --prefix=/usr .. &amp;&amp;
118ninja</userinput></screen>
119
120 <para>
121 This package does not come with a test suite.
122 </para>
123
124 <para>
125 Now, as the <systemitem class="username">root</systemitem> user:
126 </para>
127
128<screen role="root"><userinput>ninja install</userinput></screen>
129 </sect2>
130
131 <sect2 role="using">
132 <title>Using Sshfs</title>
133
134 <para>
135 To mount an ssh server you need to be able to log into the server. For
136 example, to mount your remote home folder to the local ~/examplepath (the
137 directory must exist and you must have permissions to write to it):
138 </para>
139
140<screen><userinput>sshfs example.com:/home/userid ~/examplepath</userinput></screen>
141
142 <para>
143 When you've finished work and want to unmount it again:
144 </para>
145
146<screen><userinput>fusermount3 -u ~/example</userinput></screen>
147
148 <para>
149 You can also mount an <application>sshfs</application> filesystem at boot
150 by adding an entry similar to the following in the
151 <filename>/etc/fstab</filename> file:
152 </para>
153
154 <screen><literal>userid@example.com:/path /media/path fuse.sshfs _netdev,IdentityFile=/home/userid/.ssh/id_rsa 0 0</literal></screen>
155
156 <para>
157 See <command>man 1 sshfs</command> and <command>man 8 mount.fuse</command>
158 for all available mount options.
159 </para>
160
161 </sect2>
162
163 <sect2 role="content">
164 <title>Contents</title>
165
166 <segmentedlist>
167 <segtitle>Installed Program</segtitle>
168 <segtitle>Installed Libraries</segtitle>
169 <segtitle>Installed Directories</segtitle>
170
171 <seglistitem>
172 <seg>
173 sshfs
174 </seg>
175 <seg>
176 None
177 </seg>
178 <seg>
179 None
180 </seg>
181 </seglistitem>
182 </segmentedlist>
183
184 <variablelist>
185 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
186 <?dbfo list-presentation="list"?>
187 <?dbhtml list-presentation="table"?>
188
189 <varlistentry id="sshfs-prog">
190 <term><command>sshfs</command></term>
191 <listitem>
192 <para>
193 mounts an <command>ssh</command> server as a local file system.
194 </para>
195 <indexterm zone="sshfs sshfs-prog">
196 <primary sortas="b-sshfs">sshfs</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200 </variablelist>
201 </sect2>
202</sect1>
Note: See TracBrowser for help on using the repository browser.