Artifactspublic-v0

curl

master
ply4 git calls58 ms288 KiB3 cachedprotocol v2
42 lines1.5 KiBRaw

--max-filesize

When set to a non-zero value, it specifies the maximum size (in bytes) of a file to download. If the file requested is larger than this value, the transfer does not start and curl returns with exit code 63.

Setting the maximum value to zero disables the limit.

A unit suffix letter can be used. Appending 'k' or 'K' counts the number as kilobytes, 'm' or 'M' makes it megabytes etc. The supported suffixes (k, M, G, T, P) are 1024-based. Examples: 200K, 3m and 1G. (Added in 7.58.0)

NOTE: before curl 8.4.0, when the file size is not known prior to download, for such files this option has no effect even if the file transfer ends up being larger than this given limit.

Starting with curl 8.4.0, this option aborts the transfer if it reaches the threshold during transfer.

Starting in curl 8.19.0, the maximum size can be specified using a fraction as in 2.5M for two and a half megabytes. It only works with a period (.) delimiter, independent of what your locale might prefer.

Since 8.20.0, this option also stops ongoing transfers that would reach this threshold due to automatic decompression using --compressed.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: max-filesize
5Arg: <bytes>
6Help: Maximum file size to download
7Protocols: FTP HTTP MQTT
8Category: connection ftp http mqtt
9Added: 7.10.8
10Multi: single
11See-also:
12 - limit-rate
13Example:
14 - --max-filesize 100K $URL
15 - --max-filesize 2.6M $URL
16---
18# `--max-filesize`
20When set to a non-zero value, it specifies the maximum size (in bytes) of a
21file to download. If the file requested is larger than this value, the
22transfer does not start and curl returns with exit code 63.
24Setting the maximum value to zero disables the limit.
26A unit suffix letter can be used. Appending 'k' or 'K' counts the number as
27kilobytes, 'm' or 'M' makes it megabytes etc. The supported suffixes (k, M, G,
28T, P) are 1024-based. Examples: 200K, 3m and 1G. (Added in 7.58.0)
30**NOTE**: before curl 8.4.0, when the file size is not known prior to
31download, for such files this option has no effect even if the file transfer
32ends up being larger than this given limit.
34Starting with curl 8.4.0, this option aborts the transfer if it reaches the
35threshold during transfer.
37Starting in curl 8.19.0, the maximum size can be specified using a fraction as
38in `2.5M` for two and a half megabytes. It only works with a period (`.`)
39delimiter, independent of what your locale might prefer.
41Since 8.20.0, this option also stops ongoing transfers that would reach this
42threshold due to automatic decompression using --compressed.
Diagnostics4 git calls · 58 ms
CallStatusSizeTime058 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch200898 B · hit53 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=53
git.response.bytes=898
git.response.cache=HIT
git.response.duration_ms=53
git.fetch.wants=a3adcdebf47406d5a1075cc35a09f0f0b1b6b9dc
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=898
git.pkt.payload.max=877
git.sideband.band1.bytes=876
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e302e6bc9c7929
Request
bbde2c33…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format