warning C4789: destination of memory copy is too small

最新推荐文章于 2020-02-24 13:38:30 发布
原创 最新推荐文章于 2020-02-24 13:38:30 发布 · 1.9k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#warning C4789

本文介绍了一个在Windows 7 32位环境下使用Visual Studio 2010进行C++编程时遇到的内存越界问题，示例代码中数组arr仅声明了3个元素却尝试访问第4个元素，这会导致程序运行不稳定甚至崩溃。

环境:win7 32位,vs2010

#include <iostream>
using namespace std;

int main()
{
	int arr[3];
	arr[4] = 0;
}

虽然是个waring，但居然是内存越界，必须要改的

参考：https://msdn.microsoft.com/en-us/library/w0c0bww3.aspx

12C ORA-错误汇总1 ORA-00000 to ORA-00877
ugghhj的博客
11-10 1733
12C ORA-错误汇总1 ORA-00000 to ORA-00877
iOS编程 手动忽略clang编译器警告
VictorZhang
03-31 4053
在iOS开发过程中, 我们可能会碰到一些系统方法弃用, weak、循环引用、不能执行之类的警告。 有代码洁癖的孩子们很想消除他们, 今天就让我们来一次Fuck 警告！！ 首先学会基本的语句 #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wdeprecated-declarations" 这里写出现警告的代码
The copy directory is too small
lwei_998的专栏
05-20 2253
<br />devdb01:/>#errpt<br />IDENTIFIER TIMESTAMP   T C  RESOURCE_NAME  DESCRIPTION<br />F89FB899   0518150011 P O dumpcheck             The copy directory is too small.<br />F89FB899   0517150011 P O dumpcheck             The copy directory is too small.<b
关于数组溢出------warning C4789: 内存复制的目标太小
HI的专栏
07-21 6559
 Holy  Shit！！！不小心犯了个低级错误——在使用数组时，下标使用时出错了（我一直想当然的没错，先入为主的观念），结果编译器就不干了，耗费了一点时间找出问题，但需要引以为戒！！！ 编译器警告（等级 1）C478 Visual Studio 2013 内存复制的目标太小
warning C4819的解决办法
不经一番寒彻骨，怎得梅花扑鼻香。
03-29 5473
从别处拷贝一段代码到程序运行，出现一堆的警告： warning C4819: The file contains a character that cannot be represented in the current code page (936). Save the file in Unicode format to prevent data loss。 这个警告提示反正就是和 Unico...
linux驱动开发-copy source size is too small __bad_copy_from();
gz_blog
01-29 2657
完整的报错提示如下： In function ‘check_copy_size’, inlined from ‘my_read’ at ./include/linux/uaccess.h:154:6: ./include/linux/thread_info.h:138:4: error: call to ‘__bad_copy_from’ declared with attribute...
内存复制
qq_44119514的博客
02-24 503
下列代码显示了怎么对shellcode进行内存复制，只弹出了一个dos框，只是简单的了解一下内存复制，在此不做过多解释，欢迎留言： #include "windows.h" #include "stdio.h" char shellcode[]="\x55\x8B\xEC\x33\xC0\x68\x65\x78\x65\x3F\x68\x63\x6D\x64\x2E\x89\x44\x24\x...
翻译， ====================================== INSTALLING SUBVERSION A Quick Guide ====================================== $LastChangedDate$ Contents: I. INTRODUCTION A. Audience B. Dependency Overview C. Dependencies in Detail D. Documentation II. INSTALLATION A. Building from a Tarball B. Building the Latest Source under Unix C. Building under Unix in Different Directories D. Installing from a Zip or Installer File under Windows E. Building the Latest Source under Windows F. Building using CMake III. BUILDING A SUBVERSION SERVER A. Setting Up Apache Httpd B. Making and Installing the Subversion Apache Server Module C. Configuring Apache Httpd for Subversion D. Running and Testing E. Alternative: 'svnserve' and ra_svn IV. PROGRAMMING LANGUAGE BINDINGS (PYTHON, PERL, RUBY, JAVA) I. INTRODUCTION ============ A. Audience This document is written for people who intend to build Subversion from source code. Normally, the only people who do this are Subversion developers and package maintainers. If neither of these labels fits you, we recommend you find an appropriate binary package of Subversion and install that. While the Subversion project doesn't officially release binary packages, a number of volunteers have made such packages available for different operating systems. Most Linux and BSD distributions already have Subversion packages ready to go via standard packaging channels, and other volunteers have built 'installers' for both Windows and OS X. Visit this page for package links: https://subversion.apache.org/packages.html For those of you who still wish to build from source, Subversion follows the Unix convention of "./configure && make", but it has a number of dependencies. B. Dependency Overview You'll need the following build tools to compile Subversion: * autoconf 2.59 or later (Unix only) * libtool 1.4 or later (Unix only) * a reasonable C compiler (gcc, Visual Studio, etc.) Subversion also depends on the following third-party libraries: * libapr and libapr-util (REQUIRED for client and server) The Apache Portable Runtime (APR) library provides an abstraction of operating-system level services such as file and network I/O, memory management, and so on. It also provides convenience routines for things like hashtables, checksums, and argument processing. While it was originally developed for the Apache HTTP server, APR is a standalone library used by Subversion and other products. It is a critical dependency for all of Subversion; it's the layer that allows Subversion clients and servers to run on different operating systems. * SQLite (REQUIRED for client and server) Subversion uses SQLite to manage some internal databases. * libz (REQUIRED for client and server) Subversion uses zlib for compressing binary differences. These diff streams are used everywhere -- over the network, in the repository, and in the client's working copy. * utf8proc (REQUIRED for client and server) Subversion uses utf8proc for UTF-8 support, including Unicode normalization. * Apache Serf (OPTIONAL for client) The Apache Serf library allows the Subversion client to send HTTP requests. This is necessary if you want your client to access a repository served by the Apache HTTP server. There is an alternate 'svnserve' server as well, though, and clients automatically know how to speak the svnserve protocol. Thus it's not strictly necessary for your client to be able to speak HTTP... though we still recommend that your client be built to speak both HTTP and svnserve protocols. * OpenSSL (OPTIONAL for client and server) OpenSSL enables your client to access SSL-encrypted https:// URLs (using Apache Serf) in addition to unencrypted http:// URLs. To use SSL with Subversion's WebDAV server, Apache needs to be compiled with OpenSSL as well. * Netwide Assembler (OPTIONAL for client and server) The Netwide Assembler (NASM) is used to build the (optional) assembler modules of OpenSSL. As of OpenSSL 1.1.0 NASM is the only supported assembler. * Berkeley DB (DEPRECATED and OPTIONAL for client and server) When you create a repository, you have the option of specifying a storage 'back-end' implementation. Currently, there are two options. The newer and recommended one, known as FSFS, does not require Berkeley DB. FSFS stores data in a flat filesystem. The older implementation, known as BDB, has been deprecated and is not recommended for new repositories, but is still available. BDB stores data in a Berkeley DB database. This back-end will only be available if the BDB libraries are discovered at compile time. * libsasl (OPTIONAL for client and server) If the Cyrus SASL library is detected at compile time, then the svn client (and svnserve server) will be able to utilize SASL to do various forms of authentication when speaking the svnserve protocol. * Python, Perl, Java, Ruby (OPTIONAL) Subversion is mostly a collection of C libraries with well-defined APIs, with a small collection of programs that use the APIs. If you want to build Subversion API bindings for other languages, you need to have those languages available at build time. * py3c (OPTIONAL, but REQUIRED for Python bindings) The Python 3 Compatibility Layer for C Extensions is required to build the Python language bindings. * KDE Framework 5, libsecret, GNOME Keyring (OPTIONAL for client) Subversion contains optional support for storing passwords in KWallet via KDE Framework 5 libraries (preferred) or kdelibs4, and GNOME Keyring via libsecret (preferred) or GNOME APIs. * libmagic (OPTIONAL) If the libmagic library is detected at compile time, it will be used to determine mime-types of binary files which are added to version control. Note that mime-types configured via auto-props or the mime-types-file option take precedence. C. Dependencies in Detail Subversion depends on a number of third party tools and libraries. Some of them are only required to run a Subversion server; others are necessary just for a Subversion client. This section explains what other tools and libraries will be required so that Subversion can be built with the set of features you want. On Unix systems, the './configure' script will tell you if you are missing the correct version of any of the required libraries or tools, so if you are in a real hurry to get building, you can skip straight to section II. If you want to gather the pieces you will need before starting out, however, you should read the following. If you're just installing a Subversion client, the Subversion team has created a script that downloads the minimal prerequisite libraries (Apache Portable Runtime, Sqlite, and Zlib). The script, 'get-deps.sh', is available in the same directory as this file. When run, it will place 'apr', 'apr-util', 'serf', 'zlib', and 'sqlite-amalgamation' directories directly into your unpacked Subversion distribution. With the exception of sqlite-amalgamation, they will still need to be configured, built and installed explicitly, and Subversion's own configure script may need to be told where to find them, if they were not installed in standard system locations. Note: there are optional dependencies (such as OpenSSL, swig, and httpd) which get-deps.sh does not download. Note: Because previous builds of Subversion may have installed older versions of these libraries, you may want to run some of the cleanup commands described in section II.B before installing the following. 1. Apache Portable Runtime 1.4 or newer (REQUIRED) Whenever you want to build any part of Subversion, you need the Apache Portable Runtime (APR) and the APR Utility (APR-util) libraries. If you do not have a pre-installed APR and APR-util, you will need to get these yourself: https://apr.apache.org/download.cgi On Unix systems, if you already have the APR libraries compiled and do not wish to regenerate them from source code, then Subversion needs to be able to find them. There are a couple of options to "./configure" that tell it where to look for the APR and APR-util libraries. By default it will try to locate the libraries using apr-config and apu-config scripts. These scripts provide all the relevant information for the APR and APR-util installations. If you want to specify the location of the APR library, you can use the "--with-apr=" option of "./configure". It should be able to find the apr-config script in the standard location under that directory (e.g. ${prefix}/bin). Similarly, you can specify the location of APR-util using the "--with-apr-util=" option to "./configure". It will look for the apu-config script relative to that directory. For example, if you want to use the APR libraries you built with the Apache httpd server, you could run: $ ./configure --with-apr=/usr/local/apache2 \ --with-apr-util=/usr/local/apache2 ... Notes on Windows platforms: * Do not use APR version 1.7.3 as that release contains a bug that makes it impossible for Subversion to use it properly. This issue only affects APR builds on Windows. This issue was fixed in APR version 1.7.4. See: https://lists.apache.org/thread/xd5t922jvb9423ph4j84rsp5fxks1k0z * If you check out APR and APR-util sources from their Subversion repository, be sure to use a native Windows SVN client (as opposed to Cygwin's version) so that the .dsp files get carriage-returns at the ends of their lines. Otherwise Visual Studio will complain that it doesn't recognize the .dsp files. Notes on Unix platforms: * If you check out APR and APR-util sources from their Subversion repository, you need to run the 'buildconf' script in each library's directory to regenerate the configure scripts and other files required for compiling the libraries. Afterwards, configure, build, and install both libraries before running Subversion's configure script. For example: $ cd apr $ ./buildconf $ ./configure <options...> $ make $ make install $ cd .. $ cd apr-util $ ./buildconf $ ./configure <options...> $ make $ make install $ cd .. 2. SQLite (REQUIRED) Subversion requires SQLite version 3.24.0 or above. You can meet this dependency several ways: * Use an SQLite amalgamation file. * Specify an SQLite installation to use. * Let Subversion find an installed SQLite. To use an SQLite-provided amalgamation, just drop sqlite3.c into Subversion's sqlite-amalgamation/ directory, or point to it with the --with-sqlite configure option. This file also ships with the Subversion dependencies distribution, or you can download it from SQLite: https://www.sqlite.org/download.html 3. Zlib (REQUIRED) Subversion's binary-differencing engine depends on zlib for compression. Most Unix systems have libz pre-installed, but if you need it, you can get it from http://www.zlib.net/ 4. utf8proc (REQUIRED) Subversion uses utf8proc for UTF-8 support. Configure will attempt to locate utf8proc by default using pkg-config and known paths. If it is installed in a non-standard location, then use: --with-utf8proc=/path/to/libutf8proc Alternatively, a copy of utf8proc comes bundled with the Subversion sources. If configure should use the bundled copy, use: --with-utf8proc=internal 5. autoconf 2.59 or newer (Unix only) This is required only if you plan to build from the latest source (see section II.B). Generally only developers would be doing this. 6. libtool 1.4 or newer (Unix only) This is required only if you plan to build from the latest source (see section II.B). Note: Some systems (Solaris, for example) require libtool 1.4.3 or newer. The autogen.sh script knows about that. 7. Apache Serf library 1.3.4 or newer (OPTIONAL) If you want your client to be able to speak to an Apache server (via a http:// or https:// URL), you must link against Apache Serf. Though optional, we strongly recommend this. In order to use ra_serf, you must install serf, and run Subversion's ./configure with the argument --with-serf. If serf is installed in a non-standard place, you should use --with-serf=/path/to/serf/install instead. Apache Serf can be obtained via your system's package distribution system or directly from https://serf.apache.org/. For more information on Apache Serf and Subversion's ra_serf, see the file subversion/libsvn_ra_serf/README. 8. OpenSSL (OPTIONAL) ### needs some updates. I think Apache Serf automagically handles ### finding OpenSSL, but we may need more docco here. and w.r.t ### zlib. The Apache Serf library has support for SSL encryption by relying on the OpenSSL library. a. Using OpenSSL on the client through Apache Serf On Unix systems, to build Apache Serf with OpenSSL, you need OpenSSL installed on your system, and you must add "--with-ssl" as a "./configure" parameter. If your OpenSSL installation is hard for Apache Serf to find, you may need to use "--with-libs=/path/to/lib" in addition. In particular, on Red Hat (but not Fedora Core) it is necessary to specify "--with-libs=/usr/kerberos" for OpenSSL to be found. You can also specify a path to the zlib library using "--with-libs". Under Windows, you can specify the paths to these libraries by passing the options --with-zlib and --with-openssl to gen-make.py. b. Using OpenSSL on the Apache server You can also add support for these features to an Apache httpd server to be used for Subversion using the same support libraries. The Subversion build system will not provide them, however. You add them by specifying parameters to the "./configure" script of the Apache Server instead. For getting SSL on your server, you would add the "--enable-ssl" or "--with-ssl=/path/to/lib" option to Apache's "./configure" script. Apache enables zlib support by default, but you can specify a nonstandard location for the library with the "--with-z=/path/to/dir" option. Consult the Apache documentation for more details, and for other modules you may wish to install to enhance your Subversion server. If you don't already have it, you can get a copy of OpenSSL, including instructions for building and packaging on both Unix systems and Windows, at: https://www.openssl.org/ 9. Berkeley DB 4.X (DEPRECATED and OPTIONAL) You need the Berkeley DB libraries only if you are building a Subversion server that supports the older BDB repository storage back-end, or a Subversion client that can access local BDB repositories via the file:// URI scheme. The BDB back-end has been deprecated and is not recommended for new repositories. BDB may be removed in Subversion 2.0. We recommend the newer FSFS back-end for all new repositories. FSFS does not require the Berkeley DB libraries. If in doubt, the 'svnadmin info' command, added in Subversion 1.9, can identify whether an existing repository uses BDB or FSFS. The current recommended version of Berkeley DB is 4.4.20 or newer, which brings auto-recovery functionality to the Berkeley DB database environment. If you must use an older version of Berkeley DB, we *strongly* recommend using 4.3 or 4.2 over the 4.1 or 4.0 versions. Not only are these significantly faster and more stable, but they also enable Subversion repositories to automatically clean up database journal files to save disk space. You'll need Berkeley DB installed on your system. You can get it from: http://www.oracle.com/technetwork/database/database-technologies/berkeleydb/overview/index.html If you have Berkeley DB installed in a place not searched by default for includes and libraries, add something like this: --with-berkeley-db=db.h:/usr/local/include/db4.7:/usr/local/lib/db4.7:db-4.7 to your `configure' switches, and the build process will use the Berkeley DB header and library in the named directories. You may need to use a different path, of course. Note that in order for the detection to succeed, the dynamic linker must be able to find the libraries at configure time. 10. Cyrus SASL library (OPTIONAL) If the Simple Authentication and Security Layer (SASL) library is detected on your system, then the Subversion client and svnserve server can utilize its abilities for various forms of authentication. To learn more about SASL or to get the source code, visit: http://freshmeat.net/projects/cyrussasl/ 11. Apache Web Server 2.2.X or newer (OPTIONAL) (https://httpd.apache.org/download.cgi) The Apache httpd server is one of two methods to make your Subversion repository available over a network - the other is a custom server program called svnserve, which requires no extra software packages. Building Subversion, the Apache server, and the modules that Apache needs to communicate with Subversion are complicated enough that there is a whole section at the end of this document that describes how it is done: See section III for details. 12. Python 3.x or newer (https://www.python.org/) (OPTIONAL) Subversion does not require Python for its basic operation. However, Python is required for building and testing Subversion and for using Subversion's SWIG Python bindings or hook scripts coded in Python. The majority of Subversion's test suite is written in Python, as is part of Subversion's build system. In more detail, Python is required to do any of the following: * Use the SWIG Python bindings. * Use the ctypes Python bindings. * Use hook scripts coded in Python. * Build Subversion from a tarball on Unix-like systems and run Subversion's test suite as described in section II.B. * Build Subversion on Windows as described in section II.E. * Build Subversion from a working copy checked out from Subversion's own repository (whether or not running the test suite). * Build the SWIG Python bindings. * Build the ctypes Python bindings. * Testing as described in section III.D. The Python bindings are used by: * Third-party programs (e.g., ViewVC) * Scripts distributed with Subversion itself in the tools/ subdirectory. * Any in-house scripts you may have. Python is NOT required to do any of the following: * Use the core command-line binaries (svn, svnadmin, svnsync, etc.) * Use Subversion's C libraries. * Use any of Subversion's other language bindings. * Build Subversion from a tarball on Unix-like systems without running Subversion's test suite Although this section calls for Python 3.x, Subversion still technically works with Python 2.7. However, Support for Python 2.7 is being phased out. As of 1 January 2020, Python 2.7 has reached end of life. All users are strongly encouraged to move to Python 3. Note: If you are using a Subversion distribution tarball and want to build the Python bindings for Python 2, you should rebuild the build environment in non-release mode by running 'sh autogen.sh' before running the ./configure script; see section II.B for more about autogen.sh. 13. Perl 5.8 or newer (Windows only) (OPTIONAL) To build Subversion under any of the MS Windows platforms, you will also need Perl 5.8 or newer to run apr-util's w32locatedb.pl script. 14. pkg-config (Unix only, OPTIONAL) Subversion uses pkg-config to find appropriate options used at build time. 15. D-Bus (Unix only, OPTIONAL) D-Bus is a message bus system. D-Bus is required for support for KWallet and GNOME Keyring. pkg-config is needed to find D-Bus headers and library. 16. Qt 5 or Qt 4 (Unix only, OPTIONAL) Qt is a cross-platform application framework. QtCore, QtDBus and QtGui modules are required for support for KWallet. pkg-config is needed to find Qt headers and libraries. 17. KDE 5 Framework libraries or KDELibs 4 (Unix only, OPTIONAL) Subversion contains optional support for storing passwords in KWallet. Subversion will look for KF5Wallet, KF5CoreAddons, KF5I18n APIs by default, and needs kf5-config to find them. The KDELibs 4 api is also supported. KDELibs contains core KDE libraries. Subversion uses libkdecore and libkdeui libraries when support for KWallet is enabled. kde4-config is used to get some necessary options. pkg-config, D-Bus and Qt 4 are also required. If you want to build support for KWallet, then pass the '--with-kwallet' option to `configure`. If KDE is installed in a non-standard prefix, then use: --with-kwallet=/path/to/KDE/prefix 18. GLib 2 (Unix only, OPTIONAL) GLib is a general-purpose utility library. GLib is required for support for GNOME Keyring. pkg-config is needed to find GLib headers and library. 19. GNOME Keyring (Unix only, OPTIONAL) Subversion contains optional support for storing passwords in GNOME Keyring. pkg-config is needed to find GNOME Keyring headers and library. D-Bus and GLib are also required. If you want to build support for GNOME Keyring, then pass the '--with-gnome-keyring' option to `configure`. 20. Ctypesgen (OPTIONAL) Ctypesgen is Python wrapper generator for ctypes. It is used to generate a part of Subversion Ctypes Python bindings (CSVN). If you want to build CSVN, then pass the '--with-ctypesgen' option to `configure`. If ctypesgen.py is installed in a non-standard place, then use: --with-ctypesgen=/path/to/ctypesgen.py For more information on CSVN, see subversion/bindings/ctypes-python/README. 21. libmagic (OPTIONAL) Subversion's configure script attempts to find libmagic automatically. If it is installed in a non-standard location, then use: --with-libmagic=/path/to/libmagic/prefix The files include/magic.h and lib/libmagic.so.1.0 (or similar) are expected beneath this prefix directory. If they cannot be found Subversion will be compiled without support for libmagic. If libmagic is installed but support for it should not be compiled in, then use: --with-libmagic=no If configure should fail when libmagic is not present, but only the default locations should be searched, then use: --with-libmagic 22. LZ4 (OPTIONAL) Subversion uses LZ4 compression library version r129 or above. Configure will attempt to locate the system library by default using pkg-config and known paths. If it is installed in a non-standard location, then use: --with-lz4=/path/to/liblz4 If configure should use the version bundled with the sources, use: --with-lz4=internal 23. py3c (OPTIONAL) Subversion uses the Python 3 Compatibility Layer for C Extensions (py3c) library when building the Python language bindings. As py3c is a header-only library, it is needed only to build the bindings, not to use them. Configure will attempt to locate py3c by default using pkg-config and known paths. If it is installed in a non-standard location, then use: --with-py3c=/path/to/py3c/prefix The library can be downloaded from GitHub: https://github.com/encukou/py3c On Unix systems, you can also use the provided get-deps.sh script to download py3c and several other dependencies; see the top of section I.C for more about get-deps.sh. D. Documentation The primary documentation for Subversion is the free book "Version Control with Subversion", a.k.a. "The Subversion Book", obtainable from https://svnbook.red-bean.com/. Various additional documentation exists in the doc/ subdirectory of the Subversion source. See the file doc/README for more information. II. INSTALLATION ============ Subversion support three different build systems: - Autoconf/make, for Unix builds - Visual Studio vcproj, for Windows builds - CMake, for both Unix and Windows The first two have been in use since 2001. Sections A-E below describe the classic build system. The CMake build system was created in 2024 and is still under development. It will be included in Subversion 1.15 and is expected to be the default build system starting with Subversion 1.16. Section F below describes the CMake build system. A. Building from a Tarball ------------------------------ 1. Building from a Tarball Download the most recent distribution tarball from: https://subversion.apache.org/download/ Unpack it, and use the standard GNU procedure to compile: $ ./configure $ make # make install You can also run the full test suite by running 'make check'. Even in successful runs, some tests will report XFAIL; that is normal. Failed runs are indicated by FAIL or XPASS results, or a non-zero exit code from "make check". B. Building the Latest Source under Unix ------------------------------------- These instructions assume you have already installed Subversion and checked out a working copy of Subversion's own code -- either the latest /trunk code, or some branch or tag. You also need to have already installed whatever prerequisites that version of Subversion requires (if you haven't, the ./configure step should complain). You can discard the directory created by the tarball; you're about to build the latest, greatest Subversion client. This is the procedure Subversion developers use. First off, if you have any Subversion libraries lying around from previous 'make installs', clean them up first! # rm -f /usr/local/lib/libsvn* # rm -f /usr/local/lib/libapr* # rm -f /usr/local/lib/libserf* Start the process by running "autogen.sh": $ sh ./autogen.sh This script will make sure you have all the necessary components available to build Subversion. If any are missing, you will be told where to get them from. (See the 'Dependency Overview' in section I.) Note: if the command "autoconf" on your machine does not run autoconf 2.59 or later, but you do have a new enough autoconf available, then you can specify the correct one with the AUTOCONF variable. (The AUTOHEADER variable is similar.) This may be required on Debian GNU/Linux, where "autoconf" is actually a Perl script that attempts to guess which version is required -- because of the interaction between Subversion's and APR's configuration systems, the Perl script may get it wrong. So for example, you might need to do: $ AUTOCONF=autoconf2.59 sh ./autogen.sh Once you've prepared the working copy by running autogen.sh, just follow the usual configuration and build procedure: $ ./configure $ make # make install (Optionally, you might want to pass --enable-maintainer-mode to the ./configure script. This enables debugging symbols in your binaries (among other things) and most Subversion developers use it.) Since the resulting binary depends on shared libraries, the destination library directory must be identified in your operating system's library search path. That is in either /etc/ld.so.conf or $LD_LIBRARY_PATH for Linux systems and in /etc/rc.conf for FreeBSD, followed by a run of the 'ldconfig' program. Check your system documentation for details. By identifying the destination directory, Subversion will be able to dynamically load repository access plugins. If you try to do a checkout and see an error like: subversion/libsvn_ra/ra_loader.c:209: (apr_err=170000) svn: Unrecognized URL scheme 'https://svn.apache.org/repos/asf/subversion/trunk' It probably means that the dynamic loader/linker can't find all of the libsvn_* libraries. C. Building under Unix in Different Directories -------------------------------------------- It is possible to configure and build Subversion on Unix in a directory other than the working copy. For example $ svn co https://svn.apache.org/repos/asf/subversion/trunk svn $ cd svn $ # get SQLite amalgamation if required $ chmod +x autogen.sh $ ./autogen.sh $ mkdir ../obj $ cd ../obj $ ../svn/configure [...with options as appropriate...] $ make puts the Subversion working copy in the directory svn and builds it in a separate, parallel directory obj. Why would you want to do this? Well there are a number of reasons... * You may prefer to avoid "polluting" the working copy with files generated during the build. * You may want to put the build directory and the working copy on different physical disks to improve performance. * You may want to separate source and object code and only backup the source. * You may want to remote mount the working copy on multiple machines, and build for different machines from the same working copy. * You may want to build multiple configurations from the same working copy. The last reason above is possibly the most useful. For instance you can have separate debug and optimized builds each using the same working copy. Or you may want a client-only build and a client-server build. Using multiple build directories you can rebuild any or all configurations after an edit without the need to either clean and reconfigure, or identify and copy changes into another working copy. D. Installing from a Zip or Installer File under Windows ----------------------------------------------------- Of all the ways of getting a Subversion client, this is the easiest. Download a Zip or self-extracting installer via: https://subversion.apache.org/packages.html#windows For a Zip file extract the DLLs and EXEs to a directory of your choice. Included in the download are among other tools the SVN client, the SVNADMIN administration tool and the SVNLOOK reporting tool. You may want to add the bin directory in the Subversion folder to your PATH environment variable so as to not have to use the full path when running Subversion commands. To test the installation, open a DOS box (run either "cmd" or "command" from the Start menu's "Run..." menu option), change to the directory you installed the executables into, and run: C:\test>svn co https://svn.apache.org/repos/asf/subversion/trunk svn This will get the latest Subversion sources and put them into the "svn" subdirectory. If using a self-extracting .exe file, just run it instead of unzipping it, to install Subversion. E. Building the Latest Source under Windows ---------------------------------------- E.1 Prerequisites * Microsoft Visual Studio. Any recent (2005+) version containing the Visual C++ component will work (E.g. Professional, Express, Community Edition). Make sure you enable C++ support during setup. * Python 2.7 or higher, downloaded from https://www.python.org/ which is used to generate the project files. * Perl 5.8 or higher from https://www.perl.org/get.html * Awk is needed to compile Apache. Source code is available in tools\dev\awk, run the buildwin.bat program to compile. * Apache apr, apr-util, and optionally apr-iconv libraries, version 1.4 or later (1.2 for apr-iconv). If you are building from a Subversion checkout and have not downloaded Apache 2, then get these 3 libraries from https://www.apache.org/dist/apr/. * SQLite 3.24.0 or higher from https://www.sqlite.org/download.html (3.39.4 or higher recommended) * ZLib 1.2 or higher is required and can be obtained from http://www.zlib.net/ * Either a Subversion client binary from https://subversion.apache.org/packages.html to do the initial checkout of the Subversion source or the zip file source distribution. Additional Options * [Optional] Apache Httpd 2 source, downloaded from https://httpd.apache.org/download.cgi, these instructions assume version 2.0.58. This is only needed for building the Subversion server Apache modules. ### FIXME Apache 2.2 or greater required. * [Optional] Berkeley DB for backend support of the server components are available from http://www.oracle.com/technetwork/database/database-technologies/berkeleydb/downloads/index-082944.html (Version 4.4.20 or in specific cases some higher version recommended) For more information see Section I.C.9. * [Optional] Openssl can be obtained from https://www.openssl.org/source/ * [Optional] NASM can be obtained from http://www.nasm.us/ * [Optional] A modified version of GNU libintl, called svn-win32-libintl.zip, can be used for displaying localized messages. Available at: http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=2627 * [Optional] GNU gettext for generating message catalog (.mo) files from message translations. You can get the latest binaries from http://gnuwin32.sourceforge.net/. You'll need the binaries (gettext-0.14.1-bin.zip) and dependencies (gettext-0.14.1-dep.zip). E.2 Notes The Apache Serf library supports secure connections with OpenSSL and on-the-wire compression with zlib. If you want to use the secure connections feature, you should pass the option "--with-openssl" to the gen-make.py script. See Section I.C.7 for more details. E.3 Preparation This section describes how to unpack the files to make a build tree. * Make a directory SVN and cd into it. * Either checkout Subversion: svn co https://svn.apache.org/repos/asf/subversion/trunk src-trunk or unpack the zip file distribution and rename the directory to src-trunk. * Install Visual Studio Environment. You either have to tell the installer to register environment variables or run VCVARS32.BAT before building anything. If you are using a newer Visual Studio, use the 'Visual Studio 20xx Command Prompt' on the Start menu. * Install Python and add it to your path * Install Perl (it should add itself to the path) ### Subversion doesn't need perl. Only some dependencies need it (OpenSSL and some apr scripts) * Copy AWK (awk95.exe) to awk.exe (e.g. SVN\awk\awk.exe) and add the directory containing it (e.g. SVN\awk) to the path. ### Subversion doesn't need awk. Only some dependencies need it (some apr scripts) * [Optional] Install NASM and add it to your path ### Subversion doesn't need NASM. Only some dependencies need it optionally (OpenSSL) * [Optional] If you checked out Subversion from the repository and want to build Subversion with http/https access support then install the Apache Serf sources into SVN\src-trunk\serf. * [Optional] If you want BDB backend support, extract the Berkeley DB files into SVN\src-trunk\db4-win32. It's a good idea to add SVN\src-trunk\db4-win32\bin to your PATH, so that Subversion can find the Berkeley DB DLLs. [NOTE: This binary package of Berkeley DB is provided for convenience only. Please don't address questions about Berkeley DB that aren't directly related to using Subversion to the project mailing list.] If you build Berkeley DB from the source, you will have to copy the file db-x.x.x\build_win32\db.h to SVN\src-trunk\db4-win32\include, and all the import libraries to SVN\src-trunk\db4-win32\lib. Again, the DLLs should be somewhere in your path. ### Just use --with-serf instead of the hardcoded path * [Optional] If you want to build the server modules, extract Apache source into SVN\httpd-2.x.x. * If you are building from a checkout of Subversion, and you are NOT building Apache, then you will need the APR libraries. Depending on how you got your version of APR, either: - Extract the APR, APR-util and APR-iconv source distributions into SVN\apr, SVN\apr-util, and SVN\apr-iconv respectively. Or: - Extract the apr, apr-util and apr-iconv directories from the srclib folder in the Apache httpd source into SVN\apr, SVN\apr-util, and SVN\apr-iconv respectively. ### Just use --with-apr, etc. instead of the hardcoded paths * Extract the ZLib sources into SVN\zlib if you are not using the zlib included in the dependencies zip file. ### Just use --with-zlib instead of the hardcoded path * [Optional] If you want secure connection (https) client support extract OpenSSL into SVN\openssl ### And pass the path to both serf and gen-make.py * [Optional] If you want localized message support, extract svn-win32-libintl.zip into SVN\svn-win32-libintl and extract gettext-x.x.x-bin.zip and gettext-x.x.x-dep.zip into SVN\gettext-x.x.x-bin. Add SVN\gettext-x.x.x-bin\bin to your path. * Download the SQLite amalgamation from https://www.sqlite.org/download.html and extract it into SVN\sqlite-amalgamation. See I.C.12 for alternatives to using the amalgamation package. E.4 Building the Binaries To build the binaries either follow these instructions. Start in the SVN directory you created. Set up the environment (commands should be one line even if wrapped here). C:>set VER=trunk C:>set DIR=trunk C:>set BUILD_ROOT=C:\SVN C:>set PYTHONDIR=C:\Python27 C:>set AWKDIR=C:\SVN\Awk C:>set ASMDIR=C:\SVN\asm C:>set SDKINC="C:\Program Files\Microsoft SDK\include" C:>set SDKLIB="C:\Program Files\Microsoft SDK\lib" C:>set GETTEXTBIN=C:\SVN\gettext-0.14.1-bin\bin C:>PATH=%PATH%;%BUILD_ROOT%\src-%DIR%\db4-win32;%ASMDIR%; %PYTHONDIR%;%AWKDIR%;%GETTEXTBIN% C:>set INCLUDE=%SDKINC%;%INCLUDE% C:>set LIB=%SDKLIB%;%LIB% OpenSSL < 1.1.0 C:>cd openssl C:>perl Configure VC-WIN32 [*] C:>call ms\do_masm C:>nmake -f ms\ntdll.mak C:>cd out32dll C:>call ..\ms\test C:>cd ..\.. *Note: Use "call ms\do_nasm" if you have nasm instead of MASM, or "call ms\do_ms" if you don't have an assembler. Also if you are using OpenSSL >= 1.0.0 masm is no longer supported. You will have to use do_nasm or do_ms in this case. OpenSSL >= 1.1.0 C:>cd openssl C:>perl Configure VC-WIN32 C:>nmake C:>nmake test C:>cd .. Apache 2 This step is only required for building the server dso modules. ### FIXME Apache 2.2 or greater required. Old build instructions for VC6. C:>set APACHEDIR=C:\Program Files\Apache Group\Apache2 C:>msdev httpd-2.0.58\apache.dsw /MAKE "BuildBin - Win32 Release" APR If you downloaded APR / APR-UTIL / APR_ICONV by source, you will have to build these libraries first. Building these libraries on Windows is straight forward and in most cases as simple as issuing these two commands: C:>nmake -f Makefile.win C:>nmake -f Makefile.win install Please refer to the build instructions provided by the library source for actual build instructions. ZLib If you downloaded the zlib source, you will have to build ZLib first. Building ZLib using Visual Studio should be quite simple. Just open the appropriate solution and build the project zlibstat using the IDE. Please refer to the build instructions provided by the library source for actual build instructions. Note that you'd make sure to define ZLIB_WINAPI in the ZLib config header and move the lib-file into the zlib root-directory. Please note that you MUST NOT build ZLib with the included assembler optimized code. It is known to be buggy, see for example the discussion https://svn.haxx.se/dev/archive-2013-10/0109.shtml. This means that you must not define ASMV or ASMINF. Note that the VS projects in contrib\visualstudio define these in the Debug configuration. Apache Serf ### Section about Apache Serf might be required/useful to add. ### scons is required too and Apache Serf needs to be configured prior to ### be able to build Subversion using: ### scons APR=[PATH_TO_APR] APU=[PATH_TO_APU] OPENSSL=[PATH_TO_OPENSSL] ### ZLIB=[PATH_TO_ZLIB] PREFIX=[PATH_TO_SERF_DEST] ### scons check ### scons install Subversion Things to note: * If you don't want to build mod_dav_svn, omit the --with-httpd option. The zip file source distribution contains apr, apr-util and apr-iconv in the default build location. If you have downloaded the apr files yourself you will have to tell the generator where to find the APR libraries; the options are --with-apr, --with-apr-util and --with-apr-iconv. * If you would like a debug build substitute Debug for Release in the msbuild command. * There have been rumors that Subversion on Win32 can be built using the latest cygwin, you probably don't want the zip file source distribution though. ymmv. * You will also have to distribute the C runtime dll with the binaries. Also, since Apache/APR do not provide .vcproj files, you will need to convert the Apache/APR .dsp files to .vcproj files with Visual Studio before building -- just open the Apache .dsw file and answer 'Yes To All' when the conversion dialog pops up, or you can open the individual .dsp files and convert them one at a time. The Apache/APR projects required by Subversion are: apr-util\libaprutil.dsp, apr\libapr.dsp, apr-iconv\libapriconv.dsp, apr-util\xml\expat\lib\xml.dsp, apr-iconv\ccs\libapriconv_ccs_modules.dsp, and apr-iconv\ces\libapriconv_ces_modules.dsp. * If the server dso modules are being built and tested Apache must not be running or the copy of the dso modules will fail. C:>cd src-%DIR% If Apache 2 has been built and the server modules are required then gen-make.py will already have been run. If the source is from the zip file, Apache 2 has not been built so gen-make.py must be run: C:>python gen-make.py --vsnet-version=20xx --with-berkeley-db=db4-win32 --with-openssl=..\openssl --with-zlib=..\zlib --with-libintl=..\svn-win32-libintl Then build subversion: C:>msbuild subversion_vcnet.sln /t:__MORE__ /p:Configuration=Release C:>cd .. The binaries have now been built. E.5 Packaging the binaries You now need to copy the binaries ready to make the release zip file. You also need to do this to run the tests as the new binaries need to be in your path. You can use the build/win32/make_dist.py script in the Subversion source directory to do that. [TBD: Describe how to do this. Note dependencies on zip, jar, doxygen.] E.6 Testing the Binaries [TBD: It's been a long, long while since it was necessary to move binaries around for testing. win-tests.py does that automagically. Fix this section accordingly, and probably reorder, putting the packaging at the end.] The build process creates the binary test programs but it does not copy the client tests into the release test area. C:>cd src-%DIR% C:>mkdir Release\subversion\tests\cmdline C:>xcopy /S /Y subversion\tests\cmdline Release\subversion\tests\cmdline If the server dso modules have been built then copy the dso files and dlls into the Apache modules directory. C:>copy Release\subversion\mod_dav_svn\mod_dav_svn.so "%APACHEDIR%"\modules C:>copy Release\subversion\mod_authz_svn\mod_authz_svn.so "%APACHEDIR%"\modules C:>copy svn-win32-%VER%\bin\intl.dll "%APACHEDIR%\bin" C:>copy svn-win32-%VER%\bin\iconv.dll "%APACHEDIR%\bin" C:>copy svn-win32-%VER%\bin\libdb42.dll "%APACHEDIR%\bin" C:>cd .. Put the svn-win32-trunk\bin directory at the start of your path so you run the newly built binaries and not another version you might have installed. Then run the client tests: C:>PATH=%BUILD_ROOT%\svn-win32-%VER%\bin;%PATH% C:>cd src-%DIR% C:>python win-tests.py -c -r -v If the server dso modules were built configure Apache to use the mod_dav_svn and mod_authz_svn modules by making sure these lines appear uncommented in httpd.conf: LoadModule dav_module modules/mod_dav.so LoadModule dav_fs_module modules/mod_dav_fs.so LoadModule dav_svn_module modules/mod_dav_svn.so LoadModule authz_svn_module modules/mod_authz_svn.so And further down the file add location directives to point to the test repositories. Change the paths to the SVN directory you created (paths should be on one line even if wrapped here): <Location /svn-test-work/repositories> DAV svn SVNParentPath C:/SVN/src-trunk/Release/subversion/tests/cmdline/ svn-test-work/repositories </Location> <Location /svn-test-work/local_tmp/repos> DAV svn SVNPath c:/SVN/src-trunk/Release/subversion/tests/cmdline/ svn-test-work/local_tmp/repos </Location> Then restart Apache and run the tests: C:>python win-tests.py -c -r -v -u http://localhost C:>cd .. F. Building using CMake -------------------- Get the sources, either a release tarball or by checking out the official repository. The CMake build system currently only exists in /trunk and it will be included in the 1.15 release. The process for building on Unix and Windows is the same. $ python gen-make.py -t cmake $ cmake -B out [build options] $ cmake --build out "out" in the commands above is the build directory used by CMake. Build options can be added, for example: $ cmake -B out -DCMAKE_INSTALL_PREFIX=/usr/local/subversion -DSVN_ENABLE_RA_SERF=ON Build options can be listed using: $ cmake -LH Windows tricks: - Modern versions of Microsoft Visual Studio provide support for CMake projects out-of-box, including intellisense, integrated options editor, test explorer, and more. In order to use it for Subversion, open the source directory with Visual Studio, and the configuration should start automatically. For editing the cache (options), do right-click to the CMakeLists.txt file and clicking `CMake Settings for Subversion` will open the editor. After the required settings are configured, hit `F7` in order to build. For more info, check the article bellow: https://learn.microsoft.com/en-us/cpp/build/cmake-projects-in-visual-studio - There is a useful tool for bootstrapping the dependencies, vcpkg. It provides ports for the most of the Subversion's dependencies, which then could be installed via a single command. To start using it, download the registry from GitHub, bootstrap vcpkg, and install the dependencies: $ git clone https://github.com/microsoft/vcpkg $ cd vcpkg && .\bootstrap-vcpkg.bat -disableMetrics $ .\vcpkg install apr apr-util expat zlib sqlite3 [any other dependency] After this is done, vcpkg can be integrated into CMake by passing the vcpkg toolchain to CMAKE_TOOLCHAIN_FILE option. In order to do it with Visual Studio, open the CMake cache editor as explained in the previous step, and put the following into `CMake toolchain file` field, where VCPKG_ROOT is the path to vcpkg registry: <VCPKG_ROOT>/scripts/buildsystems/vcpkg.cmake III. BUILDING A SUBVERSION SERVER ============================ Subversion has two servers you can choose from: svnserve and Apache. svnserve is a small, lightweight server program that is automatically compiled when you build Subversion's source. Apache is a more heavyweight HTTP server, but tends to have more features. This section primarily focuses on how to build Apache and the accompanying mod_dav_svn server module for it. If you plan to use svnserve instead, jump right to section E for a quick explanation. A. Setting Up Apache Httpd ----------------------- 1. Obtaining and Installing Apache Httpd 2 Subversion tries to compile against the latest released version of Apache httpd 2.2+. The easiest thing for you to do is download a source tarball of the latest release and unpack that. If you have questions about the Apache httpd 2.2 build, please consult the httpd install documentation: https://httpd.apache.org/docs-2.2/install.html At the top of the httpd tree: $ ./buildconf $ ./configure --enable-dav --enable-so --enable-maintainer-mode The first arg says to build mod_dav. The second arg says to enable shared module support which is needed for a typical compile of mod_dav_svn (see below). The third arg says to include debugging information. If you built Subversion with --enable-maintainer-mode, then you should do the same for Apache; there can be problems if one was compiled with debugging and the other without. Note: if you have multiple db versions installed on your system, Apache might link to a different one than Subversion, causing failures when accessing the repository through Apache. To prevent this from happening, you have to tell Apache which db version to use and where to find db. Add --with-dbm=db4 and --with-berkeley-db=/usr/local/BerkeleyDB.4.2 to the configure line. Make sure this is the same db as the one Subversion uses. This note assumes you have installed Berkeley DB 4.2.52 at its default locations. For more info about the db requirement, see section I.C.9. You may also want to include other modules in your build. Add --enable-ssl to turn on SSL support, and --enable-deflate to turn on compression support, for example. Consult the Apache documentation for more details. All instructions below assume you configured Apache to install in its default location, /usr/local/apache2/; substitute appropriately if you chose some other location. Compile and install apache: $ make && make install B. Making and Installing the Subversion Apache Server Module --------------------------------------------------------- Go back into your subversion working copy and run ./autogen.sh if you need to. Then, assuming Apache httpd 2.2 is installed in the standard location, run: $ ./configure Note: do *not* configure subversion with "--disable-shared"! mod_dav_svn *must* be built as a shared library, and it will look for other libsvn_*.so libraries on your system. If you see a warning message that the build of mod_dav_svn is being skipped, this may be because you have Apache httpd 2.x installed in a non-standard location. You can use the "--with-apxs=" option to locate the apxs script: $ ./configure --with-apxs=/usr/local/apache2/bin/apxs Note: it *is* possible to build mod_dav_svn as a static library and link it directly into Apache. Possible, but painful. Stick with the shared library for now; if you can't, then ask. $ rm /usr/local/lib/libsvn* If you have old subversion libraries sitting on your system, libtool will link them instead of the `fresh' ones in your tree. Remove them before building subversion. $ make clean && make && make install After the make install, the Subversion shared libraries are in /usr/local/lib/. mod_dav_svn.so should be installed in /usr/local/libexec/ (or elsewhere, such as /usr/local/apache2/modules/, if you passed --with-apache-libexecdir to configure). Section II.E explains how to build the server on Windows. C. Configuring Apache Httpd for Subversion --------------------------------------- The following section is an abbreviated version of the information in the Subversion Book (https://svnbook.red-bean.com). Please read chapter 6 for more details. The following assumes you have already created a repository. For documentation on how to do that, see README. The following also assumes that you have modified /usr/local/apache2/conf/httpd.conf to reflect your setup. At a minimum you should look at the User, Group and ServerName directives. Full details on setting up apache can be found at: https://httpd.apache.org/docs-2.2/ First, your httpd.conf needs to load the mod_dav_svn module. If you pass --enable-mod-activation to Subversion's configure, 'make install' target should automatically add this line for you. In any case, if Apache HTTPD gives you an error like "Unknown DAV provider: svn", then you may want to verify that this line exists in your httpd.conf: LoadModule dav_svn_module modules/mod_dav_svn.so NOTE: if you built mod_dav as a dynamic module as well, make sure the above line appears after the one that loads mod_dav.so. Next, add this to the *bottom* of your httpd.conf: <Location /svn/repos> DAV svn SVNPath /absolute/path/to/repository </Location> This will give anyone unrestricted access to the repository. If you want limited access, read or write, you add these lines to the Location block: AuthType Basic AuthName "Subversion repository" AuthUserFile /my/svn/user/passwd/file And: a) For a read/write restricted repository: Require valid-user b) For a write restricted repository: <LimitExcept GET PROPFIND OPTIONS REPORT> Require valid-user </LimitExcept> c) For separate restricted read and write access: AuthGroupFile /my/svn/group/file <LimitExcept GET PROPFIND OPTIONS REPORT> Require group svn_committers </LimitExcept> <Limit GET PROPFIND OPTIONS REPORT> Require group svn_committers Require group svn_readers </Limit> ### FIXME Tutorials section refers to old 2.0 docs These are only a few simple examples. For a complete tutorial on Apache access control, please consider taking a look at the tutorials found under "Security" on the following page: https://httpd.apache.org/docs-2.0/misc/tutorials.html In order for 'svn cp' to work (which is actually implemented as a DAV COPY command), mod_dav needs to be able to determine the hostname of the server. A standard way of doing this is to use Apache's ServerName directive to set the server's hostname. Edit your /usr/local/apache2/conf/httpd.conf to include: ServerName svn.myserver.org If you are using virtual hosting through Apache's NameVirtualHost directive, you may need to use the ServerAlias directive to specify additional names that your server is known by. If you have configured mod_deflate to be in the server, you can enable compression support for your repository by adding the following line to your Location block: SetOutputFilter DEFLATE NOTE: If you are unfamiliar with an Apache directive, or not exactly sure about what it does, don't hesitate to look it up in the documentation: https://httpd.apache.org/docs-2.2/mod/directives.html. NOTE: Make sure that the user 'nobody' (or whatever UID the httpd process runs as) has permission to read and write the Berkeley DB files! This is a very common problem. D. Running and Testing ------------------- Fire up apache 2: $ /usr/local/apache2/bin/apachectl stop $ /usr/local/apache2/bin/apachectl start Check /usr/local/apache2/logs/error_log to make sure it started up okay. Try doing a network checkout from the repository: $ svn co http://localhost/svn/repos wc The most common reason this might fail is permission problems reading the repository db files. If the checkout fails, make sure that the httpd process has permission to read and write to the repository. You can see all of mod_dav_svn's complaints in the Apache error logfile, /usr/local/apache2/logs/error_log. To run the regression test suite for networked Subversion, see the instructions in subversion/tests/cmdline/README. For advice about tracing problems, see "Debugging the server" in https://subversion.apache.org/docs/community-guide/. E. Alternative: 'svnserve' and ra_svn ----------------------------------- An alternative network layer is libsvn_ra_svn (on the client side) and the 'svnserve' process on the server. This is a simple network layer that speaks a custom protocol over plain TCP (documented in libsvn_ra_svn/protocol): $ svnserve -d # becomes a background daemon $ svn checkout svn://localhost/usr/local/svn/repository You can use the "-r" option to svnserve to set a logical root for repositories, and the "-R" option to restrict connections to read-only access. ("Read-only" is a logical term here; svnserve still needs write access to the database in this mode, but will not allow commits or revprop changes.) 'svnserve' has built-in CRAM-MD5 authentication (so you can use non-system accounts), and can also be tunneled over SSH (so you can use existing system accounts). It's also capable of using Cyrus SASL if libsasl2 is detected at ./configure time. Please read chapter 6 in the Subversion Book (https://svnbook.red-bean.com) for details on these features. IV. PROGRAMMING LANGUAGE BINDINGS (PYTHON, PERL, RUBY, JAVA) ======================================================== For Python, Perl and Ruby bindings, see the file ./subversion/bindings/swig/INSTALL For Java bindings, see the file ./subversion/bindings/javahl/README
06-24
cmake -G "Visual Studio 16 2019" -DCMAKE_INSTALL_PREFIX=C:\svn .. ``` #### 4. 使用 Apache 配置 Subversion 服务器 为了通过 HTTP/HTTPS 协议访问 Subversion 版本库，可以使用 Apache HTTP Server 进行配置。...
#include "strutils.h" #include <FS.h> #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) #include <ESP8266WiFi.h> #include <coredecls.h> // crc32() #include <PolledTimeout.h> #define FILENAME(f) f.fileName().c_str() #define FILEFULLNAME(f) f.fullName() #define FILESIZE(f) f.fileSize() #define FILETIME(f) f.fileTime() #define GETCREATIONTIME(f) f.getCreationTime() #define FILECREATIONTIME(f) f.fileCreationTime() #define ISFILE(f) f.isFile() #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) #include <WiFi.h> #include "PolledTimeout_esp32.h" #include <rom/miniz.h> const char * FileName(const char * path) { String name = path; if (name == "/")return path; //path should not end by / if yes need to add a sanity check int p = name.lastIndexOf("/"); if (p == -1) return path; return &path[p + 1]; } #undef crc32 #define crc32(a, len) mz_crc32( 0xffffffff,(const unsigned char *)a, len) #define FILENAME(f) FileName(f.name()) #define FILEFULLNAME(f) f.name() #define FILESIZE(f) f.size() #define FILETIME(f) f.getLastWrite() #define GETCREATIONTIME(f) f.getLastWrite() #define FILECREATIONTIME(f) f.getLastWrite() #define ISFILE(f) !f.isDirectory() //in esp32 totalbytes and usedbytes are not part of FS class //so need to call an helper to address directly SPIFFS/LITTLEFS/SD/etc... //but due to https://support.microsoft.com/en-us/topic/webdav-mapped-drive-reports-incorrect-drive-capacity-fa101657-7448-1ce6-5999-5bcc59d6a8bd //this is not used / working //so let just send 0 but keep helper as comment if in futur it is working //extern uint64_t TotalBytes(); //extern uint64_t UsedBytes(); #define TotalBytes() 0 #define UsedBytes() 0 #endif //ARDUINO_ARCH_ESP32 #include <time.h> #include <ESPWebDAV.h> #define ALLOW "PROPPATCH,PROPFIND,OPTIONS,DELETE" SCUNLOCK ",COPY" SCLOCK ",MOVE,HEAD,POST,PUT,GET" #if WEBDAV_LOCK_SUPPORT #define SLOCK "LOCK" #define SCLOCK ",LOCK" #define SUNLOCK "UNLOCK" #define SCUNLOCK ",UNLOCK" #else #define SLOCK "" #define SCLOCK "" #define SUNLOCK "" #define SCUNLOCK "" #endif #define DEBUG_LEN 160 #define PROC "proc" // simple virtual file. TODO XXX real virtual fs with user callbacks #if STREAMSEND_API static const __FlashStringHelper* streamError (Stream::Report r) { switch (r) { case Stream::Report::TimedOut: return F("Stream::send: timeout"); case Stream::Report::ReadError: return F("Stream::send: read error"); case Stream::Report::WriteError: return F("Stream::send: write error"); case Stream::Report::ShortOperation: return F("Stream::send: short transfer"); default: return F(""); } } #endif // STREAMSEND_API #if defined(ARDUINO_ARCH_ESP32) // transfer buffer #define BUF_ALLOC(bufSize, error...) \ constexpr size_t bufSize = 3 * TCP_MSS; \ char* buf = (char*)malloc(bufSize); \ if (!buf) do { error; } while (0); #define BUF_FREE() free(buf); #else // transfer buffer for small stack / heap // (esp8266 arduino core v3 should use Stream::send API for data transfer) #define BUF_ALLOC(bufSize, error...) \ constexpr size_t bufSize = 128; \ char buf[bufSize]; #define BUF_FREE() do { (void)0; } while (0) #endif #if WEBDAV_LOCK_SUPPORT void ESPWebDAVCore::makeToken(String& ret, uint32_t pash, uint32_t ownash) { char lock_token[17]; snprintf(lock_token, sizeof(lock_token), "%08x%08x", pash, ownash); ret = lock_token; } int ESPWebDAVCore::extractLockToken(const String& someHeader, const char* start, const char* end, uint32_t& pash, uint32_t& ownash) { // If: (<46dd353d7e585af1>) // => // IfToken: path:0x46dd353d / owner:0x7e585af1 pash = 0; ownash = 0; DBG_PRINT("extracting lockToken from '%s'", someHeader.c_str()); // extract "... <:[lock > int startIdx = someHeader.indexOf(start); if (startIdx < 0) { DBG_PRINT("lock: can't find '%s'", start); return 412; // fail with precondition failed } startIdx += strlen(start); int endIdx = someHeader.indexOf(end, startIdx); if (endIdx < 0) { DBG_PRINT("lock: can't find '%s'", end); return 412; // fail with precondition fail } DBG_PRINT("found in [%d..%d[ (%d)", startIdx, endIdx, endIdx - startIdx); int len = endIdx - startIdx; if (len < 1 || len > 16) { DBG_PRINT("lock: format error (1-16 hex chars)"); return 423; // fail with lock } char cp [len + 1]; memcpy(cp, &(someHeader.c_str()[startIdx]), len); cp[len] = 0; DBG_PRINT("IfToken: '%s'", cp); int ownIdx = std::max(len - 8, 0); ownash = strtoul(&cp[ownIdx], nullptr, 16); cp[ownIdx] = 0; pash = strtoul(cp, nullptr, 16); DBG_PRINT("IfToken: path:0x%08x / owner:0x%08x", pash, ownash); return 200; } #endif // WEBDAV_LOCK_SUPPORT int ESPWebDAVCore::allowed(const String& uri, uint32_t ownash) { #if WEBDAV_LOCK_SUPPORT > 1 String test = uri; while (test.length()) { stripSlashes(test); DBG_PRINT("lock: testing '%s'", test.c_str()); uint32_t hash = crc32(test.c_str(), test.length()); const auto& lock = _locks.find(hash); if (lock != _locks.end()) { DBG_PRINT("lock: found lock, %sowner!", lock->second == ownash ? "" : "not"); return lock->second == ownash ? 200 : 423; } int s = test.lastIndexOf('/'); if (s < 0) break; test.remove(s); } DBG_PRINT("lock: none found"); return 200; #else (void)uri; (void)ownash; return 200; #endif } int ESPWebDAVCore::allowed(const String& uri, const String& xml /* = emptyString */) { uint32_t hpash, anyownash; if (ifHeader.length()) { int code = extractLockToken(ifHeader, "(<", ">", hpash, anyownash); if (code != 200) return code; if (anyownash == 0) // malformed return 412; // PUT failed with 423 not 412 } else { int startIdx = xml.indexOf("<owner>"); int endIdx = xml.indexOf("</owner>"); anyownash = startIdx > 0 && endIdx > 0 ? crc32(&(xml.c_str()[startIdx + 7]), endIdx - startIdx - 7) : 0; } return allowed(uri, anyownash); } // // //void ESPWebDAVCore::stripName(String& name) //{ // if (name.length() > (size_t)_maxPathLength) // { // int dot = name.lastIndexOf('.'); // int newDot = _maxPathLength - (name.length() - dot); // if (dot <= 0 || newDot < 0) // name.remove(_maxPathLength); // else // name.remove(newDot, dot - newDot); // } //} // // 修改后的 stripName 函数：优先保留后缀，减少中文破坏 void ESPWebDAVCore::stripName(String& name) { // 仅当路径字节数超过限制时处理（避免频繁截断中文） if (name.length() > (size_t)_maxPathLength) { int dot = name.lastIndexOf('.'); // 有后缀时保留后缀（如".txt"），减少对中文的破坏 if (dot > 0 && dot < (int)name.length() - 1) { String suffix = name.substring(dot); // 提取后缀 // 计算前缀最大长度（总长度-后缀长度） int prefixLen = _maxPathLength - suffix.length(); if (prefixLen > 0) { name = name.substring(0, prefixLen) + suffix; // 拼接前缀+后缀 } } else { // 无后缀时直接截断（尽量避免触发） name = name.substring(0, _maxPathLength); } } } // // // // void ESPWebDAVCore::stripHost(String& name) { int remove = name.indexOf(hostHeader); if (remove >= 0) name.remove(0, remove + hostHeader.length()); } void ESPWebDAVCore::dir(const String& path, Print* out) { dirAction(path, true, [out](int depth, const String & parent, Dir & entry)->bool { (void)parent; for (int i = 0; i < depth; i++) out->print(" "); if (entry.isDirectory()) out->printf("[%s]\n", FILENAME(entry)); else out->printf("%-40s%4dMiB %6dKiB %d\n", FILENAME(entry), ((int)FILESIZE(entry) + (1 << 19)) >> 20, ((int)FILESIZE(entry) + (1 << 9)) >> 10, (int)FILESIZE(entry)); return true; }, /*false=subdir first*/false); } size_t ESPWebDAVCore::makeVirtual(virt_e v, String& internal) { if (v == VIRT_PROC) { #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) internal = ESP.getFullVersion(); #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) internal = "SDK:"; internal += ESP.getSdkVersion(); #endif //ARDUINO_ARCH_ESP32 internal += '\n'; } return internal.length(); } ESPWebDAVCore::virt_e ESPWebDAVCore::isVirtual(const String& uri) { const char* n = &(uri.c_str()[0]); while (*n && *n == '/') n++; if (strcmp(n, PROC) == 0) return VIRT_PROC; return VIRT_NONE; } bool ESPWebDAVCore::getPayload(StreamString& payload) { DBG_PRINT("content length=%d", (int)contentLengthHeader); payload.clear(); if (contentLengthHeader > 0) { payload.reserve(contentLengthHeader); #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) esp8266::polledTimeout::oneShotFastMs timeout(HTTP_MAX_POST_WAIT); #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) PolledTimeout timeout(HTTP_MAX_POST_WAIT); #endif //ARDUINO_ARCH_ESP32 while (payload.length() < (size_t)contentLengthHeader) { uint8_t buf[16]; auto n = client->read(buf, std::min((size_t)client->available(), sizeof(buf))); if (n <= 0 && timeout) { DBG_PRINT("get content: short read (%d < %d)", (int)payload.length(), (int)contentLengthHeader); return false; } if (n > 0) { payload.write(buf, n); timeout.reset(); } } DBG_PRINT(">>>>>>>>>>> CONTENT:"); DBG_PRINTSHORT("%s", payload.c_str()); DBG_PRINTSHORT("\n"); DBG_PRINT("<<<<<<<<<<< CONTENT"); } return true; } bool ESPWebDAVCore::dirAction(const String& path, bool recursive, const std::function<bool(int depth, const String& parent, Dir& entry)>& cb, bool callAfter, int depth) { DBG_PRINT("diraction: scanning dir '%s'", path.c_str()); #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) Dir entry = gfs->openDir(path); while (entry.next()) #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) File root = gfs->open(path); File entry = root.openNextFile(); while (entry) #endif //ARDUINO_ARCH_ESP32 { if (!entry.isDirectory()) { DBG_PRINT("diraction: %s/%s (%d B): ", path.c_str(), FILENAME(entry), (int)FILESIZE(entry)); if (cb(depth, path, entry)) { DBG_PRINT("(file-OK)"); } else { DBG_PRINT("(file-abort)"); return false; } } #if defined(ARDUINO_ARCH_ESP32) entry = root.openNextFile(); #endif //ARDUINO_ARCH_ESP32 } if (recursive) { #if defined(ARDUINO_ARCH_ESP32) root = gfs->open(path); entry = root.openNextFile(); while (entry) #endif //ARDUINO_ARCH_ESP32 #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) entry = gfs->openDir(path); while (entry.next()) #endif //ARDUINO_ARCH_ESP8266 { if (entry.isDirectory()) { DBG_PRINT("diraction: -------- %s/%s/", path.c_str(), FILENAME(entry)); if ((callAfter || cb(depth, path, entry)) && dirAction(path + '/' + FILENAME(entry), recursive, cb, callAfter, depth + 1) && (!callAfter || cb(depth, path, entry))) { DBG_PRINT("(dir-OK)"); } else { DBG_PRINT("(dir-abort)"); return false; } } #if defined(ARDUINO_ARCH_ESP32) entry = root.openNextFile(); #endif //ARDUINO_ARCH_ESP32 } } return true; } void ESPWebDAVCore::handleIssue(int code, const char* text) { String message; message.reserve(strlen(text) + uri.length() + method.length() + 32); message += text; message += "\nURI: "; message += uri; message += " Method: "; message += method; message += "\n"; String err; err.reserve(strlen(text) + 32); err += code; err += ' '; err += text; DBG_PRINT("Issue:\ntext='%s'", text); DBG_PRINT("message='%s'", message.c_str()); DBG_PRINT("err='%s'", err.c_str()); send(err, "text/plain", message); } void ESPWebDAVCore::handleRequest() { //111 ===== 新增：进度查询判断（插入到函数最开头）===== payload.clear(); // 确保和原有逻辑一致，先清空payload String originalUri = uri; // 临时保存原始uri用于判断 replaceFront(originalUri, _fsRoot, _davRoot); // 还原为客户端请求的路径 if (originalUri == "/upload-progress") // 如果是进度查询请求 { String response; if (_uploadingFile.isEmpty()) { response = "No upload in progress"; } else { response = "File: " + _uploadingFile + ", Uploaded: " + String(_uploadedBytes) + " bytes"; } send("200 OK", "text/plain", response); return; // 直接返回，不执行后续原有逻辑 } //111 ===== 新增结束 ===== payload.clear(); replaceFront(uri, _davRoot, _fsRoot); ResourceType resource = RESOURCE_NONE; // check depth header depth = DEPTH_NONE; if (depthHeader.length()) { if (depthHeader.equals("1")) depth = DEPTH_CHILD; else if (depthHeader.equals("infinity")) depth = DEPTH_ALL; DBG_PRINT("Depth: %d", depth); } File file; if (uri != "/" && !gfs->exists(uri) && (method.equals("GET") || method.equals("HEAD"))) uri += ".gz"; if (uri == "/" || gfs->exists(uri)) { // does uri refer to a file or directory or a null? file = gfs->open(uri, "r"); if (file) { resource = file.isDirectory() ? RESOURCE_DIR : RESOURCE_FILE; DBG_PRINT("resource: '%s' is %s", uri.c_str(), resource == RESOURCE_DIR ? "dir" : "file"); } else DBG_PRINT("resource: '%s': no file nor dir", uri.c_str()); } else { DBG_PRINT("resource: '%s': not exists", uri.c_str()); } DBG_PRINT("m: %s", method.c_str()); DBG_PRINT(" r: %d", resource); DBG_PRINT(" u: %s", uri.c_str()); // add header that gets sent everytime #if WEBDAV_LOCK_SUPPORT sendHeader("DAV", "1, 2"); #else sendHeader("DAV", "1"); #endif sendHeader("Accept-Ranges", "bytes"); sendHeader("Allow", ALLOW); // handle file create/uploads if (method.equals("PUT")) // payload is managed return handlePut(resource); // swallow content if (!getPayload(payload)) { handleIssue(408, "Request Time-out"); client->stop(); return; } // handle properties if (method.equals("PROPFIND")) return handleProp(resource, file); if (method.equals("GET")) return handleGet(resource, file, true); if (method.equals("HEAD")) return handleGet(resource, file, false); // handle options if (method.equals("OPTIONS")) return handleOptions(resource); #if WEBDAV_LOCK_SUPPORT // handle file locks if (method.equals("LOCK")) return handleLock(resource); if (method.equals("UNLOCK")) return handleUnlock(resource); #endif if (method.equals("PROPPATCH")) return handlePropPatch(resource, file); // directory creation if (method.equals("MKCOL")) return handleDirectoryCreate(resource); // move a file or directory if (method.equals("MOVE")) return handleMove(resource, file); // delete a file or directory if (method.equals("DELETE")) return handleDelete(resource); // delete a file or directory if (method.equals("COPY")) return handleCopy(resource, file); // if reached here, means its a unhandled handleIssue(404, "Not found"); //return false; } void ESPWebDAVCore::handleOptions(ResourceType resource) { (void)resource; DBG_PRINT("Processing OPTION"); send("200 OK", NULL, ""); } #if WEBDAV_LOCK_SUPPORT void ESPWebDAVCore::handleLock(ResourceType resource) { DBG_PRINT("Processing LOCK"); // does URI refer to an existing resource (void)resource; DBG_PRINT("r=%d/%d", resource, RESOURCE_NONE); #if WEBDAV_LOCK_SUPPORT > 1 // lock owner uint32_t hpash, ownash; if (ifHeader.length()) { int code; if ((code = extractLockToken(ifHeader, "(<", ">", hpash, ownash)) != 200) return handleIssue(code, "Lock error"); } else { int startIdx, endIdx; startIdx = payload.indexOf("<owner>"); endIdx = payload.indexOf("</owner>"); ownash = startIdx > 0 && endIdx > 0 ? crc32(&payload[startIdx + 7], endIdx - startIdx - 7) : 0; } if (!ownash) { /* XXXFIXME xml extraction should be improved (on macOS) 0:10:08.058253: <D:owner> 0:10:08.058391: <D:href>http://www.apple.com/webdav_fs/</D:href> 0:10:08.058898: </D:owner> */ ownash = 0xdeadbeef; } uint32_t pash = crc32(uri.c_str(), uri.length()); const auto& lock = _locks.find(pash); if (lock == _locks.end()) { _locks[pash] = ownash; } else { if (lock->second != ownash) { DBG_PRINT("cannot relock '%s' (owner is 0x%08x)", uri.c_str(), lock->second); return handleIssue(423, "Locked"); } DBG_PRINT("owner has relocked"); } #else const char* lock_token = "0"; #endif String lock_token; makeToken(lock_token, pash, ownash); sendHeader("Lock-Token", lock_token); #if 1 String resp; resp.reserve(500 + uri.length()); resp += F("<?xml version=\"1.0\" encoding=\"utf-8\"?>" "<D:prop xmlns:D=\"DAV:\">" "<D:lockdiscovery>" "<D:activelock>" "<D:locktoken>" "<D:href>"); resp += lock_token; resp += F("</D:href>" "</D:locktoken>" #if 0 "<D:locktype>" "<write/>" "</D:locktype>" "<D:lockscope>" "<exclusive/>" "</D:lockscope>" "<D:lockroot>" "<D:href>"); resp += uri; resp += F("</D:href>" "</D:lockroot>" "<D:depth>" "infinity" "</D:depth>"); #if 0 if (href.length()) { resp += F("<D:owner>" "<a:href xmlns:a=\"DAV:\">"); resp += href; resp += F("</a:href>" "</D:owner>"); } #endif resp += F("<D:timeout>" "Second-3600" "</D:timeout>" #endif "</D:activelock>" "</D:lockdiscovery>" "</D:prop>"); send("200 OK", "application/xml;charset=utf-8", resp); #else send("200 OK", "application/xml;charset=utf-8", ""); #endif } void ESPWebDAVCore::handleUnlock(ResourceType resource) { #if WEBDAV_LOCK_SUPPORT > 1 uint32_t pash = crc32(uri.c_str(), uri.length()); uint32_t hpash, hownash; (void)extractLockToken(lockTokenHeader, "<", ">", hpash, hownash); auto lock = _locks.find(pash); if (lock == _locks.end()) { DBG_PRINT("wasn't locked: '%s'", uri.c_str()); return handleIssue(423, "Locked"); } if (lock->second != hownash) { DBG_PRINT("lock found, bad owner 0x%08x != 0x%08x", hownash, lock->second); return handleIssue(423, "Locked"); } _locks.erase(lock); #endif (void)resource; DBG_PRINT("Processing UNLOCK"); send("204 No Content", NULL, ""); } #endif // WEBDAV_LOCK_SUPPORT void ESPWebDAVCore::handlePropPatch(ResourceType resource, File& file) { DBG_PRINT("PROPPATCH forwarding to PROPFIND"); handleProp(resource, file); } void ESPWebDAVCore::handleProp(ResourceType resource, File& file) { DBG_PRINT("Processing PROPFIND"); auto v = isVirtual(uri); if (v) resource = RESOURCE_FILE; // does URI refer to an existing resource else if (resource == RESOURCE_NONE) return handleIssue(404, "Not found"); int code; if (payload.indexOf("lockdiscovery") < 0 && (code = allowed(uri)) != 200) return handleIssue(code, "Locked"); setContentLength(CONTENT_LENGTH_UNKNOWN); send("207 Multi-Status", "application/xml;charset=utf-8", ""); sendContent(F("<?xml version=\"1.0\" encoding=\"utf-8\"?>")); sendContent(F("<D:multistatus xmlns:D=\"DAV:\">")); if (v) { // virtual file sendPropResponse(false, uri.c_str(), 1024, time(nullptr), 0); } else if (ISFILE(file) || depth == DEPTH_NONE) { DBG_PRINT("----- PROP FILE '%s':", uri.c_str()); sendPropResponse(file.isDirectory(), uri.c_str(), file.size(), file.getLastWrite(), GETCREATIONTIME(file)); } else { DBG_PRINT("----- PROP DIR '%s':", uri.c_str()); sendPropResponse(true, uri, 0, time(nullptr), 0); #if defined(ARDUINO_ARCH_ESP32) File root = gfs->open(uri); File entry = root.openNextFile(); while (entry) #endif //ARDUINO_ARCH_ESP32 #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) Dir entry = gfs->openDir(uri); while (entry.next()) #endif //ARDUINO_ARCH_ESP8266 { yield(); String path; path.reserve(uri.length() + 1 + strlen(FILENAME(entry))); path += uri; path += '/'; path += FILENAME(entry); stripSlashes(path); DBG_PRINT("Path: %s", path.c_str()); sendPropResponse(entry.isDirectory(), path.c_str(), FILESIZE(entry), FILETIME(entry), FILECREATIONTIME(entry)); #if defined(ARDUINO_ARCH_ESP32) entry = root.openNextFile(); #endif //ARDUINO_ARCH_ESP32 } } if (payload.indexOf(F("quota-available-bytes")) >= 0 || payload.indexOf(F("quota-used-bytes")) >= 0) { #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) fs::FSInfo64 info; if (gfs->info64(info)) { sendContentProp(F("quota-available-bytes"), String(1.0 * (info.totalBytes - info.usedBytes), 0)); sendContentProp(F("quota-used-bytes"), String(1.0 * info.usedBytes, 0)); } #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) //NEED TO BE not related to SPIFFS //use external functions //but SPIFFS/FAT size_t because in MB //and SD uint64_t because in GB //so use uint64_t sendContentProp(F("quota-available-bytes"), String(1.0 * (TotalBytes() - UsedBytes()), 0)); sendContentProp(F("quota-used-bytes"), String(1.0 * UsedBytes(), 0)); #endif //ARDUINO_ARCH_ESP32 } sendContent(F("</D:multistatus>")); } void ESPWebDAVCore::sendContentProp(const String& what, const String& response) { String one; one.reserve(100 + 2 * what.length() + response.length()); one += F("<esp:"); one += what; one += F(">"); one += response; one += F("</esp:"); one += what; one += F(">"); sendContent(one); } void ESPWebDAVCore::sendPropResponse(bool isDir, const String& fullResPathFS, size_t size, time_t lastWrite, time_t creationDate) { String fullResPath = fullResPathFS; replaceFront(fullResPath, _fsRoot, _davRoot); fullResPath = c2enc(fullResPath); String blah; blah.reserve(100); blah += F("<D:response xmlns:esp=\"DAV:\"><D:href>"); blah += fullResPath; blah += F("</D:href><D:propstat><D:status>HTTP/1.1 200 OK</D:status><D:prop>"); sendContent(blah); sendContentProp(F("getlastmodified"), date2date(lastWrite)); sendContentProp(F("creationdate"), date2date(creationDate)); DBG_PRINT("-----\nentry: '%s'(dir:%d)\n-----", fullResPath.c_str(), isDir); if (isDir) { sendContentProp(F("resourcetype"), F("<D:collection/>")); } else { sendContentProp(F("getcontentlength"), String(size)); sendContentProp(F("getcontenttype"), contentTypeFn(fullResPath)); sendContent("<resourcetype/>"); char entityTag [uri.length() + 32]; sprintf(entityTag, "%s%lu", uri.c_str(), (unsigned long)lastWrite); uint32_t crc = crc32(entityTag, strlen(entityTag)); sprintf(entityTag, "\"%08x\"", crc); sendContentProp(F("getetag"), entityTag); } sendContentProp(F("displayname"), fullResPath); sendContent(F("</D:prop></D:propstat></D:response>")); } void ESPWebDAVCore::handleGet(ResourceType resource, File& file, bool isGet) { DBG_PRINT("Processing GET (ressource=%d)", (int)resource); // does URI refer to an existing file resource auto v = isVirtual(uri); if (!v) { if (resource == RESOURCE_DIR) return handleIssue(200, "GET/HEAD on dir"); if (resource != RESOURCE_FILE) return handleIssue(404, "Not found"); } // no lock on GET #if DBG_WEBDAV long tStart = millis(); #endif size_t fileSize = file.size(); String contentType = contentTypeFn(uri); if (uri.endsWith(".gz")) //&& contentType != "application/x-gzip" && contentType != "application/octet-stream") sendHeader("Content-Encoding", "gzip"); String internal = emptyString; if (v) { fileSize = makeVirtual(v, internal); } else if (!fileSize) { setContentLength(0); send("200 OK", contentType.c_str(), ""); DBG_PRINT("send empty file"); return; } BUF_ALLOC(bufSize, return send("500 Memory full", contentType.c_str(), "")); // Content-Range: bytes 0-1023/146515 // Content-Length: 1024 int remaining; if (_rangeStart == 0 && (_rangeEnd < 0 || _rangeEnd == (int)fileSize - 1)) { _rangeEnd = fileSize - 1; remaining = fileSize; setContentLength(remaining); send("200 OK", contentType.c_str(), ""); } else { if (_rangeEnd == -1 || _rangeEnd >= (int)fileSize) { _rangeEnd = _rangeStart + (2 * TCP_MSS - 100); if (_rangeEnd >= (int)fileSize) _rangeEnd = fileSize - 1; } snprintf(buf, bufSize, "bytes %d-%d/%d", _rangeStart, _rangeEnd, (int)fileSize); sendHeader("Content-Range", buf); remaining = _rangeEnd - _rangeStart + 1; setContentLength(remaining); send("206 Partial Content", contentType.c_str(), ""); } if (isGet && (internal.length() || file.seek(_rangeStart, SeekSet))) { DBG_PRINT("GET: (%d bytes, remain=%d)", remaining, remaining); if (internal.length()) { // send virtual content if (transferStatusFn) transferStatusFn(file.name(), (100 * _rangeStart) / fileSize, false); if (client->write(&internal.c_str()[_rangeStart], remaining) != (size_t)remaining) { DBG_PRINT("file->net short transfer"); } else if (transferStatusFn) transferStatusFn(file.name(), (100 * (_rangeStart + remaining)) / fileSize, false); } else { if (transferStatusFn) transferStatusFn(file.name(), 0, false); int percent = 0; while (remaining > 0 && file.available()) { #if STREAMSEND_API size_t numRead = file.sendSize(client, 2 * TCP_MSS); if (file.getLastSendReport() != Stream::Report::Success) { String error; error.reserve(64); error += F("Write data failed: "); error += streamError(file.getLastSendReport()); DBG_PRINT("WebDav: Get: file('%s') error: %s\n", file.name(), error.c_str()); break; // abort transfer } #else // !STREAMSEND_API #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) #warning NOT using Stream::sendSize #endif size_t toRead = (size_t)remaining > bufSize ? bufSize : remaining; size_t numRead = file.read((uint8_t*)buf, toRead); DBG_PRINT("read %d bytes from file", (int)numRead); if (client->write(buf, numRead) != numRead) { DBG_PRINT("file->net short transfer"); break; // abort transfer } #endif // !STREAMSEND_API #if 0 && DBG_WEBDAV for (size_t i = 0; i < 80 && i < numRead; i++) DBG_PRINTSHORT("%c", buf[i] < 32 || buf[i] > 127 ? '.' : buf[i]); #endif remaining -= numRead; if (transferStatusFn) { int p = (100 * (file.size() - remaining)) / file.size(); if (p != percent) { transferStatusFn(file.name(), percent = p, false); } } DBG_PRINT("wrote %d bytes to http client", (int)numRead); } } } BUF_FREE(); DBG_PRINT("File %zu bytes sent in: %ld sec", fileSize, (millis() - tStart) / 1000); } void ESPWebDAVCore::handlePut(ResourceType resource) { DBG_PRINT("Processing Put"); // does URI refer to a directory if (resource == RESOURCE_DIR) return handleIssue(404, "Not found"); int code ; if ((code = allowed(uri)) != 200) return handleIssue(code, "Lock error"); //222 ===== 新增：上传开始时初始化进度（在创建文件之前）===== _uploadingFile = uri; // 记录当前上传的文件名 _uploadedBytes = 0; // 初始化为0字节 //222 ===== 新增结束 ===== File file; stripName(uri); DBG_PRINT("create file '%s'", uri.c_str()); #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) if (!(file = gfs->open(uri, "w"))) #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) String s = uri; if (uri[0] != '/') s = "/" + uri; DBG_PRINT("Create file %s", s.c_str()); if (!(file = gfs->open(s, "w"))) #endif //ARDUINO_ARCH_ESP32 { return handleWriteError("Unable to create a new file", file); } //777 ===== 修正：记录最终用于创建文件的路径 ===== #if defined(ARDUINO_ARCH_ESP32) _uploadingFile = s; // ESP32 用拼接后的路径 #else _uploadingFile = uri; // ESP8266 用原始 uri #endif _uploadedBytes = 0; // 7777============================================== // file is created/open for writing at this point // did server send any data in put DBG_PRINT("%s - ready for data (%i bytes)", uri.c_str(), (int)contentLengthHeader); if (contentLengthHeader != 0) { #if DBG_WEBDAV long tStart = millis(); #endif size_t numRemaining = contentLengthHeader; if (transferStatusFn) transferStatusFn(file.name(), 0, true); int percent = 0; #if STREAMSEND_API while (numRemaining > 0) { auto sent = client->sendSize(file, std::min(numRemaining, (size_t)(2 * TCP_MSS)), HTTP_MAX_POST_WAIT); if (client->getLastSendReport() != Stream::Report::Success) { String error; error.reserve(64); error += F("Write data failed: "); error += streamError(client->getLastSendReport()); DBG_PRINT("WebDav: Put: file('%s') error: %s\n", file.name(), error.c_str()); return handleWriteError(error, file); } numRemaining -= sent; //666 ===== 新增：STREAM 模式下更新上传进度 ===== _uploadedBytes += sent; // 关键：累加本次发送的字节数 //666 ============================================== if (transferStatusFn) { int p = (100 * (contentLengthHeader - numRemaining)) / contentLengthHeader; if (p != percent) { transferStatusFn(file.name(), percent = p, true); } } } #else // !STREAMSEND_API #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) #warning NOT using Stream::sendSize #endif BUF_ALLOC(bufSize, return handleWriteError("Memory full", file)); // read data from stream and write to the file while (numRemaining > 0) { size_t numToRead = numRemaining; if (numToRead > bufSize) numToRead = bufSize; auto numRead = readBytesWithTimeout((uint8_t*)buf, numToRead); if (numRead == 0) break; size_t written = 0; while (written < numRead) { auto numWrite = file.write((uint8_t*)buf + written, numRead - written); if (numWrite == 0 || (int)numWrite == -1) { DBG_PRINT("error: numread=%d write=%d written=%d", (int)numRead, (int)numWrite, (int)written); BUF_FREE(); return handleWriteError("Write data failed", file); } written += numWrite; } // reduce the number outstanding numRemaining -= numRead; //333 ===== 新增：更新已上传字节数 ===== _uploadedBytes += numRead; //333 ===== 新增结束 ===== if (transferStatusFn) { int p = (100 * (contentLengthHeader - numRemaining)) / contentLengthHeader; if (p != percent) { transferStatusFn(file.name(), percent = p, true); } } } BUF_FREE(); // detect timeout condition if (numRemaining) return handleWriteError("Timed out waiting for data", file); #endif // !STREAMSEND_API DBG_PRINT("File %zu bytes stored in: %ld sec", (contentLengthHeader - numRemaining), ((millis() - tStart) / 1000)); } DBG_PRINT("file written ('%s': %d = %d bytes)", String(file.name()).c_str(), (int)contentLengthHeader, (int)file.size()); if (resource == RESOURCE_NONE) send("201 Created", NULL, ""); else send("200 OK", NULL, ""); } void ESPWebDAVCore::handleWriteError(const String& message, File& file) { // close this file file.close(); // delete the wrile being written gfs->remove(uri); // send error send("500 Internal Server Error", "text/plain", message); DBG_PRINT("%s", message.c_str()); } void ESPWebDAVCore::handleDirectoryCreate(ResourceType resource) { DBG_PRINT("Processing MKCOL (r=%d uri='%s' cl=%d)", (int)resource, uri.c_str(), (int)contentLengthHeader); if (contentLengthHeader) return handleIssue(415, "Unsupported Media Type"); // does URI refer to anything if (resource != RESOURCE_NONE) return handleIssue(405, "Not allowed"); int parentLastIndex = uri.lastIndexOf('/'); if (parentLastIndex > 0) { File testParent = gfs->open(uri.substring(0, parentLastIndex), "r"); if (!testParent.isDirectory()) return handleIssue(409, "Conflict"); } if (!gfs->mkdir(uri)) { // send error send("500 Internal Server Error", "text/plain", "Unable to create directory"); DBG_PRINT("Unable to create directory"); return; } DBG_PRINT("%s directory created", uri.c_str()); send("201 Created", NULL, ""); } void ESPWebDAVCore::handleMove(ResourceType resource, File& src) { const char* successCode = "201 Created"; DBG_PRINT("Processing MOVE"); //////// does URI refer to anything if (resource == RESOURCE_NONE || destinationHeader.length() == 0) { return handleIssue(404, "Not found"); } DBG_PRINT("dest header : %s\n", destinationHeader.c_str()); DBG_PRINT("urlToUri : %s\n", urlToUri(destinationHeader).c_str()); String dest = enc2c(urlToUri(destinationHeader)); stripHost(dest); stripSlashes(dest); stripName(dest); replaceFront(dest, _davRoot, _fsRoot); // DBG_PRINT("Move destination: %s", dest.c_str()); int code; if ((code = allowed(uri)) != 200 || (code = allowed(dest)) != 200) return handleIssue(code, "Locked"); File destFile; if (gfs->exists(dest) || (dest == "/")) destFile = gfs->open(dest, "r"); if (destFile && !ISFILE(destFile)) { dest += '/'; dest += src.name(); stripSlashes(dest); stripName(dest); destFile.close(); destFile = gfs->open(dest, "r"); successCode = "204 No Content"; // MOVE to existing collection resource didn't give 204 } if (destFile) { if (overwrite.equalsIgnoreCase("F")) return handleIssue(412, "Precondition Failed"); if (destFile.isDirectory()) { destFile.close(); deleteDir(dest); } else { destFile.close(); gfs->remove(dest); } } src.close(); DBG_PRINT("finally rename '%s' -> '%s'", uri.c_str(), dest.c_str()); if (!gfs->rename(uri, dest)) { // send error send("500 Internal Server Error", "text/plain", "Unable to move"); DBG_PRINT("Unable to move file/directory"); return; } DBG_PRINT("Move successful"); send(successCode, NULL, ""); } bool ESPWebDAVCore::mkFullDir(String fullDir) { bool ret = true; stripSlashes(fullDir); int idx = 0; while (idx != -1) { idx = fullDir.indexOf('/', idx + 1); String part = idx == -1? /*last part*/fullDir: fullDir.substring(0, idx); ret = gfs->mkdir(part); // might already exist, keeping on } return ret; // return last action success } bool ESPWebDAVCore::deleteDir(const String& dir) { // delete content of directory dirAction(dir, true, [this](int depth, const String & parent, Dir & entry)->bool { (void)depth; String toRemove; toRemove.reserve(parent.length() + strlen(FILENAME(entry)) + 2); toRemove += parent; toRemove += '/'; toRemove += FILENAME(entry); bool ok = !!(entry.isDirectory() ? gfs->rmdir(toRemove) : gfs->remove(toRemove)); DBG_PRINT("DELETE %s %s: %s", entry.isDirectory() ? "[ dir]" : "[file]", toRemove.c_str(), ok ? "ok" : "bad"); return ok; }); DBG_PRINT("Delete dir '%s'", dir.c_str()); gfs->rmdir(dir); return true; } void ESPWebDAVCore::handleDelete(ResourceType resource) { DBG_PRINT("Processing DELETE '%s'", uri.c_str()); // does URI refer to anything if (resource == RESOURCE_NONE) return handleIssue(404, "Not found"); int code; if ((code = allowed(uri)) != 200) return handleIssue(code, "Locked"); bool retVal; if (resource == RESOURCE_FILE) retVal = gfs->remove(uri); else retVal = deleteDir(uri); DBG_PRINT("handleDelete: uri='%s' ress=%s ret=%d\n", uri.c_str(), resource == RESOURCE_FILE?"file":"dir", retVal); // for some reason, parent dir can be removed if empty // need to leave it there (also to pass compliance tests). int parentIdx = uri.lastIndexOf('/'); if (parentIdx >= 0) { uri.remove(parentIdx); if (uri.length()) { DBG_PRINT("Recreating directory '%s'\n", uri.c_str()); if (!mkFullDir(uri)) { DBG_PRINT("Error recreating directory '%s'\n", uri.c_str()); } } } if (!retVal) { // send error send("500 Internal Server Error", "text/plain", "Unable to delete"); DBG_PRINT("Unable to delete file/directory"); return; } DBG_PRINT("Delete successful"); send("200 OK", NULL, ""); } bool ESPWebDAVCore::copyFile(File srcFile, const String& destName) { File dest; if (overwrite.equalsIgnoreCase("F")) { dest = gfs->open(destName, "r"); if (dest) { DBG_PRINT("copy dest '%s' already exists and overwrite is false", destName.c_str()); handleIssue(412, "Precondition Failed"); return false; } } #if defined(ARDUINO_ARCH_ESP8266) || defined(CORE_MOCK) dest = gfs->open(destName, "w"); #endif //ARDUINO_ARCH_ESP8266 #if defined(ARDUINO_ARCH_ESP32) String s = destName; if (destName[0] != '/')s = "/" + destName; dest = gfs->open(s, "w"); DBG_PRINT("Create file %s", s.c_str()); #endif //ARDUINO_ARCH_ESP32 if (!dest) { handleIssue(413, "Request Entity Too Large"); return false; } #if STREAMSEND_API srcFile.sendAll(dest); if (srcFile.getLastSendReport() != Stream::Report::Success) { handleIssue(500, String(streamError(srcFile.getLastSendReport())).c_str()); return false; } #else // !STREAMSEND_API BUF_ALLOC(bufSize, handleIssue(500, "Memory Full")); while (srcFile.available()) { yield(); int nb = srcFile.read((uint8_t*)buf, bufSize); if (!nb) { DBG_PRINT("copy: short read"); BUF_FREE(); handleIssue(500, "Internal Server Error"); return false; } int wr = dest.write((const uint8_t*)buf, nb); if (wr != nb) { DBG_PRINT("copy: short write wr=%d != rd=%d", (int)wr, (int)nb); BUF_FREE(); handleIssue(500, "Internal Server Error"); return false; } } BUF_FREE(); #endif // !STREAMSEND_API return true; } void ESPWebDAVCore::handleCopy(ResourceType resource, File& src) { const char* successCode = "201 Created"; DBG_PRINT("Processing COPY"); if (resource == RESOURCE_NONE) return handleIssue(404, "Not found"); if (!src) // || resource != RESOURCE_FILE) return handleIssue(413, "Request Entity Too Large"); String destParentPath = destinationHeader; { int j = -1; for (int i = 0; i < 3; i++) j = destParentPath.indexOf('/', j + 1); destParentPath.remove(0, j); } String destPath = destParentPath; if (destPath.length()) { if (destPath[destPath.length() - 1] == '/') { // add file name destPath += src.name(); successCode = "204 No Content"; // COPY to existing resource should give 204 (RFC2518:S8.8.5) } else { // remove last part int lastSlash = destParentPath.lastIndexOf('/'); if (lastSlash > 0) destParentPath.remove(lastSlash); } } replaceFront(destPath, _davRoot, _fsRoot); replaceFront(destParentPath, _davRoot, _fsRoot); DBG_PRINT("copy: src='%s'=>'%s' dest='%s'=>'%s' parent:'%s'", uri.c_str(), FILEFULLNAME(src), destinationHeader.c_str(), destPath.c_str(), destParentPath.c_str()); File destParent = gfs->open(destParentPath, "r"); stripName(destPath); int code; if (/*(code = allowed(uri)) != 200 ||*/ (code = allowed(destParentPath)) != 200 || (code = allowed(destPath)) != 200) return handleIssue(code, "Locked"); // copy directory if (src.isDirectory()) { DBG_PRINT("Source is directory"); if (ISFILE(destParent)) { DBG_PRINT("'%s' is not a directory", destParentPath.c_str()); return handleIssue(409, "Conflict"); } if (!dirAction(FILEFULLNAME(src), depth == DEPTH_ALL, [this, destParentPath](int depth, const String & parent, Dir & source)->bool { (void)depth; (void)parent; String destNameX = destParentPath + '/'; destNameX += FILENAME(source); stripName(destNameX); DBG_PRINT("COPY: '%s' -> '%s", FILENAME(source), destNameX.c_str()); return copyFile(gfs->open(FILENAME(source), "r"), destNameX); })) { return; // handleIssue already called by failed copyFile() handleIssue(409, "Conflict"); } } else { DBG_PRINT("Source is file"); // (COPY into non-existant collection '/litmus/nonesuch' succeeded) if (!destParent || !destParent.isDirectory()) { DBG_PRINT("dest dir '%s' not existing", destParentPath.c_str()); return handleIssue(409, "Conflict"); } // copy file if (!copyFile(src, destPath)) return; } DBG_PRINT("COPY successful"); send(successCode, NULL, ""); } void ESPWebDAVCore::_prepareHeader(String& response, const String& code, const char* content_type, size_t contentLength) { response = "HTTP/1.1 " + code + "\r\n"; if (content_type) sendHeader("Content-Type", content_type, true); if ((size_t)_contentLengthAnswer == CONTENT_LENGTH_NOT_SET) sendHeader("Content-Length", String(contentLength)); else if ((size_t)_contentLengthAnswer != CONTENT_LENGTH_UNKNOWN) sendHeader("Content-Length", String(_contentLengthAnswer)); else //if ((size_t)_contentLengthAnswer == CONTENT_LENGTH_UNKNOWN) { _chunked = true; //sendHeader("Accept-Ranges", "none"); sendHeader("Transfer-Encoding", "chunked"); } if (m_persistent) sendHeader("Connection", "keep-alive"); else sendHeader("Connection", "close"); response += _responseHeaders; response += "\r\n"; } bool ESPWebDAVCore::parseRequest(const String& givenMethod, const String& givenUri, WiFiClient* givenClient, ContentTypeFunction givenContentTypeFn) { method = givenMethod; DBG_PRINT("given uri : %s\n", givenUri.c_str()); uri = enc2c(givenUri); // uri = (givenUri); stripSlashes(uri); client = givenClient; contentTypeFn = givenContentTypeFn; DBG_PRINT("############################################"); DBG_PRINT(">>>>>>>>>> RECV"); DBG_PRINT("method: %s", method.c_str()); DBG_PRINT(" url: %s", uri.c_str()); // parse and finish all headers String headerName; String headerValue; _rangeStart = 0; _rangeEnd = -1; DBG_PRINT("INPUT"); // no new client is waiting, allow more time to current client m_persistent_timer_ms = millis(); // TODO always true m_persistent = ((millis() - m_persistent_timer_ms) < m_persistent_timer_init_ms); // reset all variables _chunked = false; _responseHeaders.clear(); _contentLengthAnswer = (int)CONTENT_LENGTH_NOT_SET; contentLengthHeader = 0; depthHeader.clear(); hostHeader.clear(); destinationHeader.clear(); overwrite.clear(); ifHeader.clear(); lockTokenHeader.clear(); while (1) { String req = client->readStringUntil('\r'); client->readStringUntil('\n'); if (req == "") // no more headers break; int headerDiv = req.indexOf(':'); if (headerDiv == -1) break; headerName = req.substring(0, headerDiv); headerValue = req.substring(headerDiv + 2); DBG_PRINT("\theader name is : %s", headerName.c_str()); DBG_PRINT("\theader value is : %s", headerValue.c_str()); if (headerName.equalsIgnoreCase("Host")) hostHeader = headerValue; else if (headerName.equalsIgnoreCase("Depth")) depthHeader = headerValue; else if (headerName.equalsIgnoreCase("Content-Length")) contentLengthHeader = headerValue.toInt(); else if (headerName.equalsIgnoreCase("Destination")) destinationHeader = headerValue; else if (headerName.equalsIgnoreCase("Range")) processRange(headerValue); else if (headerName.equalsIgnoreCase("Overwrite")) overwrite = headerValue; else if (headerName.equalsIgnoreCase("If")) ifHeader = headerValue; else if (headerName.equalsIgnoreCase("Lock-Token")) lockTokenHeader = headerValue; } DBG_PRINT("<<<<<<<<<< RECV"); bool ret = true; /*ret =*/ handleRequest(); // finalize the response if (_chunked) sendContent(""); return ret; } size_t ESPWebDAVCore::readBytesWithTimeout(uint8_t *buf, size_t size) { size_t where = 0; while (where < size) { int timeout_ms = HTTP_MAX_POST_WAIT; while (!client->available() && client->connected() && timeout_ms--) delay(1); if (!client->available()) break; where += client->read(buf + where, size - where); } return where; } void ESPWebDAVCore::sendHeader(const String& name, const String& value, bool first) { String headerLine = name + ": " + value + "\r\n"; if (first) _responseHeaders = headerLine + _responseHeaders; else _responseHeaders += headerLine; } void ESPWebDAVCore::send(const String& code, const char* content_type, const String& content) { String header; _prepareHeader(header, code, content_type, content.length()); client->write(header.c_str(), header.length()); //DBG_PRINT(">>>>>>>>>> SENT"); //DBG_PRINT("---- header: \n%s", header.c_str()); if (content.length()) { sendContent(content); #if DBG_WEBDAV DBG_PRINT("send content (%d bytes):", (int)content.length()); for (size_t i = 0; i < DEBUG_LEN && i < content.length(); i++) DBG_PRINTSHORT("%c", content[i] < 32 || content[i] > 127 ? '.' : content[i]); if (content.length() > DEBUG_LEN) DBG_PRINTSHORT("..."); DBG_PRINTSHORT("\n"); #endif } //DBG_PRINT("<<<<<<<<<< SENT"); } bool ESPWebDAVCore::sendContent(const String& content) { return sendContent(content.c_str(), content.length()); } bool ESPWebDAVCore::sendContent(const char* data, size_t size) { if (_chunked) { char chunkSize[32]; snprintf(chunkSize, sizeof(chunkSize), "%x\r\n", (int)size); size_t l = strlen(chunkSize); if (client->write(chunkSize, l) != l) return false; DBG_PRINT("---- chunk %s", chunkSize); } #if DBG_WEBDAV DBG_PRINT("---- %scontent (%d bytes):", _chunked ? "chunked " : "", (int)size); for (size_t i = 0; i < DEBUG_LEN && i < size; i++) DBG_PRINTSHORT("%c", data[i] < 32 || data[i] > 127 ? '.' : data[i]); if (size > DEBUG_LEN) DBG_PRINTSHORT("..."); DBG_PRINTSHORT("\n"); #endif if (client->write(data, size) != size) { DBG_PRINT("SHORT WRITE"); return false; } if (_chunked) { if (client->write("\r\n", 2) != 2) { DBG_PRINT("SHORT WRITE 2"); return false; } if (size == 0) { DBG_PRINT("END OF CHUNKS"); _chunked = false; } } DBG_PRINT("OK with sendContent"); return true; } bool ESPWebDAVCore::sendContent_P(PGM_P content) { const char * footer = "\r\n"; size_t size = strlen_P(content); if (_chunked) { char chunkSize[32]; snprintf(chunkSize, sizeof(chunkSize), "%x%s", (int)size, footer); size_t l = strlen(chunkSize); if (client->write(chunkSize, l) != l) return false; } if (client->write_P(content, size) != size) { DBG_PRINT("SHORT WRITE"); return false; } if (_chunked) { if (client->write(footer, 2) != 2) { DBG_PRINT("SHORT WRITE 2"); return false; } if (size == 0) { DBG_PRINT("END OF CHUNKS"); _chunked = false; } } DBG_PRINT("OK with sendContent_P"); return true; } void ESPWebDAVCore::setContentLength(size_t len) { _contentLengthAnswer = len; } void ESPWebDAVCore::processRange(const String& range) { // "Range": "bytes=0-5" // "Range": "bytes=0-" size_t i = 0; while (i < range.length() && (range[i] < '0' || range[i] > '9')) i++; size_t j = i; while (j < range.length() && range[j] >= '0' && range[j] <= '9') j++; if (j > i) { _rangeStart = atoi(&range.c_str()[i]); if (range.c_str()[j + 1]) _rangeEnd = atoi(&range.c_str()[j + 1]); else _rangeEnd = -1; } DBG_PRINT("Range: %d -> %d", _rangeStart, _rangeEnd); }
最新发布
10-31
- 复制（COPY） 错误排查常见点： 1. 初始化失败：检查文件系统（如SPIFFS或LittleFS）是否挂载成功。 2. 连接问题：确保设备已连接到网络，且客户端可以访问设备的IP地址和端口（通常为80）。 3. 认证失败：...
在运行ocrconfig replace ocrmirror命令时出现PROT-22: Storage too small错误
haofeifei的专栏
02-25 1417
操作系统：redhat4.3 数据库：oracle10.2.0.1 虚拟机的环境：vmware9 由于想做迁移OCR磁盘的测试，原OCR磁盘为256M，后来创建了一个260M的磁盘， 在运行ocrconfig replace ocrmirror /dev/raw/raw10命令时出现PROT-22: Storage too small错误 后来又添加了一个300M的磁盘，还是报PRO
【e语言】内存偏移查看源代码
10-18
内存偏移查看源代码 e语言的，编译后可用，用在DNF里蛮不错的哦
errorC4146 errorC4308 errorC4532 errorC4533 errorC4700 errorC4703 errorC4789 errorC4995 errorC4996
小松鼠的专栏
04-28 1253
这个错误和安全开发生命周期（SDL）检查有关，vs2012之后加入（vs2012、vs2013、vs2015）。MSDN相关介绍  相关其他错误： 解决方法： 项目属性->配置属性->C/C++->SDL检查  否 就不会出现
方法三：CSocket类
HI的专栏
07-13 1402
 CSocket类 CSocket类介绍 CSocket类派生于CAsyncSocket，对Windows Socket API进行更高层次的封装。它支持同步操作，可以单独使用，但通常情况下与CSocketFile、 CArchive类一起实现数据的发送和接收。下面介绍CSocket的主要方法。 （1）Create方法 Create方法用于创建一个套接字。 语法： BOOL
使用VS编程，提示warning c4789：内存复制的目标太小，如何解决？
06-18
### 解决VS编程中Warning C4789内存复制目标缓冲区太小的问题 在Visual Studio (VS) 编程中，警告C4789表示在执行内存复制操作时，目标缓冲区的大小不足以容纳要复制的数据[^1]。这种问题通常发生在使用`std::...
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值