socket_common: small simplification in read() calculation
[ruby-mogilefs-client.git] / README
blob1c49e5f2ceecb2be0e2d326c162242e2f6fb500a
1 = mogilefs-client - MogileFS client library for Ruby
3 A MogileFS client library for Ruby.  MogileFS is an open source
4 distributed filesystem, see: http://mogilefs.org for more details.  This
5 library allows any Ruby application to read, write and delete files in a
6 MogileFS instance.
8 == Links
10 rdoc :: http://bogomips.org/mogilefs-client
11 mogilefs :: http://mogilefs.org/
12 list :: mailto:mogile@googlegroups.com
13 email :: mailto:normalperson@yhbt.net
14 repo :: git://bogomips.org/mogilefs-client.git
15 cgit :: http://bogomips.org/mogilefs-client.git
16 gitweb :: http://repo.or.cz/w/ruby-mogilefs-client.git
18 == Install
20 First you need a MogileFS 2.x installation.  You can find information on
21 how to do that at http://mogilefs.org
23 Then install the RubyGem:
25   $ gem install mogilefs-client
27 This library supports Ruby 1.8.7 and later, but Ruby 1.9.3 is
28 recommended.  No other libraries are required on the client.
30 == Usage
32 See MogileFS::MogileFS
34 == Contact
36 Feedback (bug reports, user/development dicussion, patches, pull
37 requests) are greatly appreciated and handled via email.  We currently
38 piggy-back onto the public MogileFS
39 {mailing list}[mailto:mogile@googlegroups.com] for feedback.
41 If you do not want to deal with the corporate host of the MogileFS
42 mailing list, or if you wish to keep your issue secret, feel free to
43 email {Eric Wong at}[mailto:normalperson@yhbt.net].
45 Do not expect Eric Wong to read HTML mail under any circumstances.
47 == WARNING!
49 This client is only supported in HTTP mode.  NFS mode was previously
50 supported in 1.3.x, but since MogileFS 2.x has dropped support for
51 NFS, this client has removed support for it.