Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/memmove.9
| Show All 23 Lines | ||||||||||
| .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |||||||||
| .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |||||||||
| .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |||||||||
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |||||||||
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |||||||||
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |||||||||
| .\" SUCH DAMAGE. | .\" SUCH DAMAGE. | |||||||||
| .\" | .\" | |||||||||
| .Dd June 19, 2026 | .Dd July 1, 2026 | |||||||||
| .Dt MEMMOVE 9 | .Dt MEMMOVE 9 | |||||||||
| .Os | .Os | |||||||||
| .Sh NAME | .Sh NAME | |||||||||
| .Nm memmove | .Nm memmove , | |||||||||
| .Nm memmove_data | ||||||||||
markjUnsubmitted Done Inline Actions
markj: | ||||||||||
| .Nd copy bytes in memory | .Nd copy bytes in memory | |||||||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | |||||||||
| .In sys/systm.h | .In sys/systm.h | |||||||||
| .Ft void * | .Ft void * | |||||||||
| .Fn memmove "void *dst" "const void *src" "size_t len" | .Fn memmove "void *dst" "const void *src" "size_t len" | |||||||||
| .Ft void * | ||||||||||
| .Fn memmove_data "void *dst" "const void *src" "size_t len" | ||||||||||
| .Sh DESCRIPTION | .Sh DESCRIPTION | |||||||||
| The | The | |||||||||
| .Fn memmove | .Fn memmove | |||||||||
| function copies | function copies | |||||||||
| .Fa len | .Fa len | |||||||||
| bytes from object | bytes from object | |||||||||
| .Fa src | .Fa src | |||||||||
| to object | to object | |||||||||
| .Fa dst . | .Fa dst . | |||||||||
| The two objects may overlap; | The two objects may overlap; | |||||||||
| the copy is always done in a non-destructive manner. | the copy is always done in a non-destructive manner and preserves | |||||||||
| the provenance of pointers in the copied object | ||||||||||
| .Pq see Xr memory_model 7 for further information . | ||||||||||
| The | ||||||||||
| .Fn memmove_data | ||||||||||
Done Inline Actions
markj: | ||||||||||
| function does the same except that it does not preserve the provenance | ||||||||||
Done Inline Actions
Same comment as above emaste: Same comment as above | ||||||||||
| of pointers in the copied object. | ||||||||||
| On CHERI targets, the validity tag of any copied capability is | ||||||||||
| explicitly cleared. | ||||||||||
| .Sh RETURN VALUES | .Sh RETURN VALUES | |||||||||
| The | The | |||||||||
| .Fn memmove | .Fn memmove | |||||||||
| function returns the original value of | and | |||||||||
| .Fn memmove_data | ||||||||||
| functions return the original value of | ||||||||||
| .Fa dst . | .Fa dst . | |||||||||
| .Sh SEE ALSO | .Sh SEE ALSO | |||||||||
| .Xr bcopy 9 , | .Xr bcopy 9 , | |||||||||
| .Xr memcpy 9 | .Xr memcpy 9 , | |||||||||
| .Xr memcpy_data 9 | ||||||||||
| .Sh STANDARDS | .Sh STANDARDS | |||||||||
| The | The | |||||||||
| .Fn memmove | .Fn memmove | |||||||||
| function | function | |||||||||
| conforms to | conforms to | |||||||||
| .St -isoC . | .St -isoC . | |||||||||
| .Sh HISTORY | ||||||||||
| The | ||||||||||
| .Fn memmove_data | ||||||||||
| function first appeared in | ||||||||||
| .Fx 16.0 . | ||||||||||