19 Commits

Author SHA1 Message Date
Nguyen Hai
4409da697f Update doc building instructions in Development Guidelines
Change-Id: Ifd2f468ad745d19ef474ae7503a8bd79d429fc1b
2018-07-06 07:40:52 +00:00
Zuul
a5569ddd6b Merge "Be consistent about capitalizing Swift in the README" 2018-07-05 09:53:18 +00:00
Tim Burke
7bacd53062 Be consistent about capitalizing Swift in the README
Change-Id: If6441d61ee0cb11641c38d46763db6244e05e275
2018-07-04 23:06:10 -07:00
Tim Burke
f27f1ae649 Make docs link consistent
We already link to Swift's docs in particular (as opposed to OpenStack's
in general) later in the README, may as well do it earlier, too.

Change-Id: Ib11bfb551e44ccc6bbbad9d78e1e20d6486a3103
2018-07-04 23:02:42 -07:00
Alistair Coles
108304ea69 Improve README doc building instructions
Dependencies must be installed before the docs
can successfully be built with sphinx.

Change-Id: Idd896408ecf6d9afd37ae5701cdbc224b029fd2f
2018-06-28 09:19:11 +01:00
Nguyen Hai
891861546d Update README related to documentation building
New command is:
sphinx-build -W -b html doc/source doc/build/html

Change-Id: I185ae7d69093660ab558cf866ae36e45bf213975
2018-06-28 13:47:06 +09:00
melissaml
e5ce83b967 Update links in README
Change the outdated links to the latest links in README

Change-Id: Ic68cc654722d47d761b308381f2ab489f3d13703
2018-03-11 02:42:48 +08:00
vxlinux
ddb13aa5ea Remove redundant blank space in README.rst
Change-Id: If347476e3b9185921ff174d3f8170a1c4d0622e8
2018-01-20 17:23:35 +08:00
guotao
0d324c16de Update http with https
Use https instead of http for some links in readme.rst

Change-Id: Idd382f58108e96129c69c6dc149c694fd7833fb3
2018-01-16 14:31:27 +08:00
Samuel Merritt
728b4ba140 Add checksum to object extended attributes
Currently, our integrity checking for objects is pretty weak when it
comes to object metadata. If the extended attributes on a .data or
.meta file get corrupted in such a way that we can still unpickle it,
we don't have anything that detects that.

This could be especially bad with encrypted etags; if the encrypted
etag (X-Object-Sysmeta-Crypto-Etag or whatever it is) gets some bits
flipped, then we'll cheerfully decrypt the cipherjunk into plainjunk,
then send it to the client. Net effect is that the client sees a GET
response with an ETag that doesn't match the MD5 of the object *and*
Swift has no way of detecting and quarantining this object.

Note that, with an unencrypted object, if the ETag metadatum gets
mangled, then the object will be quarantined by the object server or
auditor, whichever notices first.

As part of this commit, I also ripped out some mocking of
getxattr/setxattr in tests. It appears to be there to allow unit tests
to run on systems where /tmp doesn't support xattrs. However, since
the mock is keyed off of inode number and inode numbers get re-used,
there's lots of leakage between different test runs. On a real FS,
unlinking a file and then creating a new one of the same name will
also reset the xattrs; this isn't the case with the mock.

The mock was pretty old; Ubuntu 12.04 and up all support xattrs in
/tmp, and recent Red Hat / CentOS releases do too. The xattr mock was
added in 2011; maybe it was to support Ubuntu Lucid Lynx?

Bonus: now you can pause a test with the debugger, inspect its files
in /tmp, and actually see the xattrs along with the data.

Since this patch now uses a real filesystem for testing filesystem
operations, tests are skipped if the underlying filesystem does not
support setting xattrs (eg tmpfs or more than 4k of xattrs on ext4).

References to "/tmp" have been replaced with calls to
tempfile.gettempdir(). This will allow setting the TMPDIR envvar in
test setup and getting an XFS filesystem instead of ext4 or tmpfs.

THIS PATCH SIGNIFICANTLY CHANGES TESTING ENVIRONMENTS

With this patch, every test environment will require TMPDIR to be
using a filesystem that supports at least 4k of extended attributes.
Neither ext4 nor tempfs support this. XFS is recommended.

So why all the SkipTests? Why not simply raise an error? We still need
the tests to run on the base image for OpenStack's CI system. Since
we were previously mocking out xattr, there wasn't a problem, but we
also weren't actually testing anything. This patch adds functionality
to validate xattr data, so we need to drop the mock.

`test.unit.skip_if_no_xattrs()` is also imported into `test.functional`
so that functional tests can import it from the functional test
namespace.

The related OpenStack CI infrastructure changes are made in
https://review.openstack.org/#/c/394600/.

Co-Authored-By: John Dickinson <me@not.mn>

Change-Id: I98a37c0d451f4960b7a12f648e4405c6c6716808
2017-11-03 13:30:05 -04:00
junboli
df00122e74 doc migration: update the doc link address[2/3]
Update the doc link brought by the doc migration.
Although we had some effort to fix these, it still left lots of bad
doc link, I separate these changes into 3 patches aim to fix all of
these, this is the 2st patch for doc/manpages.

Change-Id: Id426c5dd45a812ef801042834c93701bb6e63a05
2017-09-15 06:31:00 +00:00
zhangdebo1987
8db22bdc1f Correct documentation link address in README
Correct documentation link address in README.

Change-Id: I1f6ac13eebf05e5deb7fe07ae7a202e1dd4e544a
2017-08-02 15:54:55 +08:00
Tim Burke
61bcd75971 README: dedent the numbered list
It looks funny otherwise.

Change-Id: Ib00872e050a2885e43085f907780bc9ff0d2b381
2017-06-01 18:15:24 +00:00
M V P Nitesh
71516ae990 Optimize the link address
Use https instead of http to ensure the safety

Change-Id: Ifdce2d0fde8ccd758cf3290cdf82faef244c8004
2017-04-10 15:23:05 +05:30
Flavio Percoco
dd87fe2963 Show team and repo badges on README
This patch adds the team's and repository's badges to the README file.
The motivation behind this is to communicate the project status and
features at first glance.

For more information about this effort, please read this email thread:

http://lists.openstack.org/pipermail/openstack-dev/2016-October/105562.html

To see an example of how this would look like check:

https://gist.github.com/185b807657793d710f29d87ea7ec3e56

Change-Id: I78815177dba9d765587d9a0aee4e0f76e14a043e
2016-11-25 16:36:49 +01:00
maoshuai
e7f025f7fa made link in README.rst more clear
Escaping the underscore is not necessary in this case. See
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#inline-markup-recognition-rules

Change-Id: I21d95d6baaf471246eb8a931c7df366634529512
2016-08-01 15:43:25 +00:00
Saverio Proto
ce022f4417 README: fix broken link
There is a broken link to CONTRIBUTING.rst
introduced in commit a829bd59770681f9d6c1ef02a6e1d5e441587a23

Change-Id: Iaedf5ff3995229cf292202793809080f9f2c7fed
2016-05-12 15:31:51 +02:00
John Dickinson
6827affe62 Rework the contributor docs
This started as a new "new_contributor" doc. But we've already got
at least 3 different docs like that.

Change-Id: Ia2303ab55eeea01cc71acbccaeab55dad0ef5ff9
2016-05-05 22:02:47 -07:00
Tin Lam
0e7fca576c Convert README.md to README.rst
Change-Id: I223890bd4ffe469becc2127f9362243cdb52bc08
Closes-Bug: #1567026
2016-04-12 17:46:56 -05:00