Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Created new branch. #429

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Created new branch. #429

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
211 changes: 211 additions & 0 deletions articles/copy-file-with-rsync.asm.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,211 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- file: templates/articles/assembly.xml -->
<?xml-model href="https://cdn.docbook.org/schema/5.2/rng/assemblyxi.rnc"
type="application/relax-ng-compact-syntax"?>
<!DOCTYPE assembly
[
<!ENTITY % entities SYSTEM "../common/generic-entities.ent">
%entities;
]>
<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
<!-- point back to this document with a similar comment added to your legacy doc piece -->
<!-- refer to README.md for file and id naming conventions -->
<assembly version="5.2" xml:lang="en"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:trans="http://docbook.org/ns/transclusion"
xmlns:its="http://www.w3.org/2005/11/its"
xmlns="http://docbook.org/ns/docbook">
<!-- resources section references all topic chunks used in the final article
-->
<!-- R E S O U R C E S -->
<!-- Glue files -->
<!--><resources>
<resource xml:id="_glue-example" href="../glues/glue.xml">
<description>Glue example</description>
</resource>
<resource xml:id="_glue-more-info" href="../glues/glue-more-info.xml">
<description>Glue for more information</description>
</resource>
<resource xml:id="_glue-whats-next" href="../glues/glue-whats-next.xml">
<description>Glue what's next</description>
</resource>
</resources>
-->
<!-- Concept files -->

<resources>
<resource xml:id="_copy-file-with-rsync-concept" href="../concepts/copy-file-with-rsync-concept.xml">
<description>Copying files using rsync</description>
</resource>
<resource xml:id="_copy-file-with-rsync-locally" href="../concepts/copy-file-with-rsync-locally.xml">
<description>Copying files and directories using rsync locally</description>
</resource>
<resource xml:id="_copy-file-with-rsync-remotely" href="../concepts/copy-file-with-rsync-remotely.xml">
<description>Copying files and directories using rsync remotely</description>
</resource>
<resource xml:id="_copy-file-with-rsync-usage" href="../concepts/copy-file-with-rsync-usage.xml">
<description>Use rsync to copy files and directories.</description>
</resource>
<resource xml:id="_copy-file-with-rsync-delete-update" href="../concepts/copy-file-with-rsync-delete-update.xml">
<description>Use rsync to update and delete files and directories.</description>
</resource>
<resource xml:id="_copy-file-with-rsync-troubleshooting" href="../concepts/copy-file-with-rsync-troubleshooting.xml">
<description>The steps to follow if rsync fails to copy files or directories</description>
</resource>
</resources>

<!-- Tasks -->

<resources>

<resource xml:id="_copy-file-with-rsync-configure-rsync-server" href="../tasks/copy-file-with-rsyc-configure-rsync-server.xml">
<description>Use rsync to copy files and directories.</description>
</resource>

</resources>

<!-- References -->
<!--
<resources>
<resource xml:id="_reference-example" href="../references/reference.xml">
<description>Reference example</description>
</resource>
</resources>
-->
<!-- Legal -->
<resources>
<resource href="../common/legal.xml" xml:id="_legal">
<description>Legal Notice</description>
</resource>
<resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl">
<description>GNU Free Documentation License</description>
</resource>
</resources>
<!-- S T R U C T U R E -->
<structure renderas="article" xml:id="copy-files-directories-with-rsync" xml:lang="en">
<merge>
<title>Copying Files and Directories with rsync</title>
<!-- <subtitle>Subtitle if necessary</subtitle> -->
<!-- Create changelog to enable versioning; add most recent entries at the top. -->
<revhistory xml:id="rh-copy-file-with-rsync">
<revision><date>2025-02-18</date>
<revdescription>
<para>
Initial version
</para>
</revdescription>
</revision>
</revhistory>
<!-- TODO: provide a listing of possible and validatable meta entry values. Maybe in our geekodoc repo? -->
<!-- add author's e-mail -->
<meta name="Shalaka Harne" content="[email protected]" its:translate="no"/>
<!-- ISO date of last update as YYYY-MM-DD
<meta name="updated" content="2023-11-11" its:translate="no"/> -->
<!-- this does not work yet. Use the dm tags listed below for now
<meta name="bugtracker" its:translate="no">
<phrase role="url">https://bugzilla.suse.com/enter_bug.cgi</phrase>
<phrase role="component">Non-product-specific documentation</phrase>
<phrase role="product">Smart Docs</phrase>
<phrase role="assignee">[email protected]</phrase>
</meta>
-->
<!-- not supported, yet. Use dm: tag for now
<meta name="translation" its:translate="no">
<phrase role="trans">yes</phrase>
<phrase role="language">de-de,cs-cz</phrase>
</meta>
-->
<!-- enter the platform identifier or a list of
identifiers, separated by ; -->
<meta name="architecture" content="x86;power" its:translate="no"/>
<meta name="productname" its:translate="no">
<!-- enter product name and version --><productname version="16">&sles;</productname>
</meta>
<meta name="title" its:translate="yes">How to Copy Files and Directories Using rsync</meta>
<meta name="description" its:translate="yes">An overview of copying files and directories locally and remotely using rsync</meta>
<meta name="social-descr" its:translate="yes">Copy files and directories with rsync</meta>
<!-- suitable category, comma-separated list of categories -->
<meta name="category" content="Systems Management" its:translate="no"/>
<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker>
<dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
<dm:component>Smart Docs</dm:component>
<dm:product os="sles">SUSE Linux Enterprise Server 16.0</dm:product>
<dm:assignee>[email protected]</dm:assignee>
</dm:bugtracker>
<dm:translation>yes</dm:translation>
</dm:docmanager>
<abstract>
<variablelist>
<varlistentry>
<term>WHAT?</term>
<listitem>
<para>
You can use the rsync tool to copy files locally or remotely. rsync is unidirectional and can copy files only in one direction.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WHY?</term>
<listitem>
<para>
This article provides an overview of the rsync tool and its basic usage for copying files locally and remotely.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>EFFORT</term>
<listitem>
<para>
It takes up to 20 minutes to understand the basic usage of the rsync tool.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>GOAL</term>
<listitem>
<para>
Gain a foundational understanding of rsync and how to use it for file transfers.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>REQUIREMENTS</term>
<listitem>
<para>
Access permissions to the source and destination locations for copying files.
</para>
</listitem>
</varlistentry>
</variablelist>
</abstract>
</merge>
<!-- pull in all the topic files you need -->
<!-- pick the appropriate type of include to match your needs -->
<!-- pull in a topic as is -->
<!--module resourceref="_glue-example" renderas="section"/>
<! pull in a topic and switch the title
<module resourceref="_concept-example" renderas="section">
<merge>
<title>You are a very special concept now!</title>
</merge>
</module>-->
<!--module resourceref="_task-example" renderas="section"/>
<module resourceref="_reference-example" renderas="section"/>
<module resourceref="_glue-more-info" renderas="section"/>
<module resourceref="_glue-whats-next" renderas="section"/>-->
<module resourceref="_copy-file-with-rsync-concept" renderas="section"/>
<!--module resourceref="_copy-file-with-rsync-usage" renderas="section"/>-->
<module resourceref="_copy-file-with-rsync-usage" renderas="section"/>
<module resourceref="_copy-file-with-rsync-locally" renderas="section"/>
<module resourceref="_copy-file-with-rsync-remotely" renderas="section"/>

<module resourceref="_copy-file-with-rsync-configure-rsync-server" renderas="section"/>
<module resourceref="_copy-file-with-rsync-delete-update" renderas="section"/>
<module resourceref="_copy-file-with-rsync-troubleshooting" renderas="section"/>
<module resourceref="_legal"/>
<module resourceref="_gfdl">
<output renderas="appendix"/>
</module>
</structure>
</assembly>