go-ipfs
is built on top of Golang, which allows for some cross platform compatibility. However, it doesn’t cover everything. Over the past few weeks, we’ve fine-tuned several aspects of the Windows experience to fix errors and remove inconsistencies.
In this post, we’ll be taking a closer look at these issues and what we’ve done to resolve them before the next release of go-ipfs
(v0.4.15). (CORRECTION: “Log output” and “File output names” have been pushed back to v0.4.16, everything else will be included in v0.4.15)
If you’re not a Windows or go-ipfs
user, you may still be interested in seeing where we encountered problem points, and our resolution plans for them. Issue #4808 (Windows initiative 2018) in particular may give you a head start if you plan on porting go-ipfs
to a new platform, or are encountering inconsistent behavior in one of your own projects. It offers a more in-depth look at how we discovered, discussed, and dealt with platform problems.
Log output
Issue:
The output on Windows was filled with non-native control characters. This made our output hard to read, both for users and developers (when malformed logs were shared with us).
Resolution:
We’ve added a method of translating these characters into native equivalents. There should be no more oddities related to character color or cursor placement, text should be clear and lines shouldn’t overlap anymore. This should make everyone a little bit happier.
Building
Issue:
Building the Windows binary, on Windows itself, had multiple problems: silent failures, lack of respect for user supplied arguments, inconsistent handling of dependencies, and more.
Resolution:
Multiple fixes had to be applied to go-ipfs
, gx
, some of our first and third party dependencies, and even Golang itself. The building experience should now be consistent with other platforms. In addition, the documentation has been rewritten to clarify the process and add a section that covers Windows specific concerns and how to deal with them.
Temporary file access errors
Issue:
When trying to move data-blocks from a temporary location, the destination address was getting corrupted. This led to “Access Denied” errors and the unexpected creation of garbage files in the working directory.
Resolution:
An audit is in progress, directed at finding areas where memory corruption is possible. We’ve detected and resolved the Windows specific issue above. Operations should now succeed as expected.
File output names
Issue:
No filters were being applied to file paths during extraction (IPFS -> other file systems). This caused multiple issues when using ipfs get
.
Extracting content from IPFS could fail due to native file system restrictions
FAT32, NTFS, ReFS, and Windows itself, all impose their own path limitations. If a hash contained a non-legal path, operations likeipfs get
would fail. In the image above, the XKCD archive could not be downloaded on Windows because the directory “1031 – s keyboard leopard ” ends in a space.Hashes that contained malicious file paths would be extracted
It was possible for users to craft specific hashes that could escape the extraction root and overwrite files (if the target file’s location was known in advance and users had write permissions for the files).
Resolution:
We now account for these limitations and translate path-names into platform legal paths, which are restricted to their hash-root.
stdio
Issue:
stdin support was explicitly disabled in go-ipfs
, preventing basic IPC with other applications. Resolution:
stdin support has been added to the Windows version of go-ipfs which allows you to place ipfs anywhere in a pipeline.
And more…
There’s still more to be done to enhance the experience of go-ipfs
on Windows. As well as address portability concerns in general. We plan to keep making progress in these areas going forward. If you’re interested in contributing (or just keeping an eye on progress), feel free to check out issue #4808 (Windows initiative 2018).
Want to contribute?
Would you like to contribute to the IPFS project and don’t know how? Well, there are a few places you can get started:
- Check the issues with the
help wanted
label at the Ready column in our waffle board – https://waffle.io/ipfs/go-ipfs?label=help%20wanted - Join an IPFS All Hands call, introduce yourself and let us know where you would like to contribute – https://github.com/ipfs/pm/#all-hands-call
- The All Hands call is also the perfect venue for demos, join in and show us what you built!
- Join the discussion at http://discuss.ipfs.io/
Do you have questions?
The best place to ask your questions about IPFS, how it works, and what you can do with it is at discuss.ipfs.io. We are also available at the #ipfs channel on Freenode.
官方原文:https://blog.ipfs.io/36-a-look-at-windows
点对点科技简介
点对点科技深耘IPFS与Filecoin技术,坚持区块链技术改变未来的信念。点对点 IPFS 数据中心是目前国内技术领先,性价比高、保障优的投资标的。自建杭州数据中心,合作数据中心分布于上海、宁波、河北、香港、斯德哥尔摩(瑞典)等地。点对点数据中心具有优秀的硬件配置与目前国内优质的网络节点资源。点对点科技力求将IPFS爱好者升级为IPFS领军者与受益者,让IPFS颠覆传统互联网,共同开启 WEB 3.0时代。
想了解更多区块链知识吗?关注我吧!
原创文章,作者:点对点Tech,如若转载,请注明出处:https://ipfsdrop.com/offcial/ipfs/a-look-at-go-ipfs-on-windows/