File: README

package info (click to toggle)
hubicfuse 1.1.0-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 360 kB
  • ctags: 218
  • sloc: ansic: 1,834; sh: 340; makefile: 42
file content (101 lines) | stat: -rw-r--r-- 3,848 bytes parent folder | download
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

HubicFuse is a FUSE application which provides access to Hubic's
cloud files via a mount-point.

BUILDING:

    You'll need libcurl, fuse, libssl, and libxml2 (and probably their dev
    packages) installed to build it.  From a base Debian or Ubuntu install,
    this should get you to a point you can build and run it:
        apt-get install build-essential libcurl4-openssl-dev libxml2-dev \
             libssl-dev libfuse-dev libjson0-dev pkg-config

    For CentOS or similar,
        yum install gcc make fuse-devel curl-devel libxml2-devel \
            openssl-devel json-c-devel
            
    For Debian or Ubuntu,
        apt-get install gcc make libfuse-dev libcurl-dev \
            libcurl4-openssl-dev libxml2-dev libssl-dev libjson-c-dev

    Cloudfuse is built and installed like any other autoconf configured code.
    Normally,
        ./configure
        make
        sudo make install

USE:

    Your Hubic Cloud configuration can be placed in a file named
    $HOME/.cloudfuse. All the following variables are required:

        username=[Hubic user e-mail]
        password=[Hubic password]
        client_id=[Hubic client id for the registered application]
        client_secret=[Hubic client secret for the registered application]
        redirect_uri=[Hubic redirect uri as registered for the application]

    client_id, client_secret and redirect_uri can be retrieved from the hubic
    web interface: https://hubic.com/home/browser/developers/

    Then you can call hubicfuse:

        sudo hubicfuse /mnt/hubic -o noauto_cache,sync_read,allow_other

    It is possible to pass (or override) some variables on the command line:

        sudo hubicfuse /mnt/hubic \
           -o username='xxx',password='xxx',noauto_cache,sync_read,allow_other

    And finaly, it can be set in /etc/fstab:

        hubicfuse /mnt/hubic fuse username=xxx,password=xxx...,user,noauto 0 0

    It also inherits a number of command-line arguments and mount options from
    the Fuse framework.  The "-h" argument should provide a summary.

USE AS NON-ROOT:

    Add the user into the fuse group:

       $ sudo usermod -a -G fuse [username]

    Mount using the above command without the sudo. The .cloudfuse file is
    search into the user's home.

    To unmount use:

       $ fusermount -u [chemin]

BUGS/SHORTCOMINGS:

    * rename() doesn't work on directories (and probably never will).
    * When reading and writing files, it buffers them in a local temp file.
    * It keeps an in-memory cache of the directory structure, so it may not be
      usable for large file systems.  Also, files added by other applications
      will not show up until the cache expires.
    * The root directory can only contain directories, as these are mapped to
      containers in cloudfiles.
    * Directory entries are created as empty files with the content-type
      "application/directory".
    * Cloud Files limits container and object listings to 10,000 items.
      cloudfuse won't list more than that many files in a single directory.


AWESOME CONTRIBUTORS:

    * Pascal Obry                                  https://github.com/TurboGit
    * Tim Dysinger                                 https://github.com/dysinger
    * Chris Wedgwood                               https://github.com/cwedgwood
    * Nick Craig-Wood                              https://github.com/ncw
    * Dillon Amburgey                              https://github.com/dillona
    * Manfred Touron                               https://github.com/moul
    * David Brownlee                               https://github.com/abs0
    * Mike Lundy                                   https://github.com/novas0x2a
    * justinb                                      https://github.com/justinsb


Thanks, and I hope you find it useful.

Pascal Obry
<pascal@obry.net>