实验提交¶

实验一提交 实验报告 和 实验代码(只提交commit.patch文件) 。

1. 实验报告会纳入评分（虽然不多）¶

实验报告要求 回答实验中的问题，并写出实验设计思路和运行结果 。

实验报告也是证明实验是独立完成的重要依据，有分数追求的大佬（juanwang）们不要只放代码和指导书的截图。

2. 实验代码（只提交commit.patch文件）¶

不需要提交完整的代码包，只需要提交commit.patch文件即可，操作步骤如下：

编写好3个程序(sleep、pingpong、find)后，在xv6-oslab24-hitsz项目目录下，运行make grade，查看是否都能通过。
做完xv6启动流程实验后，将gdb命令脚本命名为 commands.gdb，放在xv6-oslab24-hitsz项目包里，具体要求详见：关于 gdb 命令脚本如何导出。
在完成上述两个步骤之后，将当前分支上的所有更改进行提交（commit，具体方法参考git使用教程，即执行git add .和git commit -m "lab1 finished"这两条指令）。
在仓库的目录下使用make diff命令导出更改文件（commit.patch），该命令会 比较你上一次commit的代码与实验初始代码 ，所以一定要记得commit。
将 生成的commit.patch文件 与 实验报告 一起打包提交到作业提交平台即可。

如何检验提交上去的commit.patch文件是否正确

建议你通过make diff生成commit.patch文件后，再按照下面这个步骤检测一下再提交commit.patch文件，否则可能出现自己是对的但是自动评测脚本没分的情况。在检验过程中请不要进行额外的git操作，如果已经开始了检验步骤，务必进行到底！

git stash(如果你当前没有未提交更改，可以忽略这一步)

说明：该命令将你当前工作目录中的未提交更改（包括已修改的文件和已暂存的文件）暂时保存起来，并将工作目录恢复到干净的状态（即恢复到最近一次 commit 的状态）。这样可以防止当前正在编辑或未提交的文件与后续的操作（如切换分支或应用补丁）发生冲突。这样你可以在后续操作完成后恢复这些未提交的更改。
git checkout util-base-24

说明：切换到对应分支的标签，如果你在做实验二syscall则改为syscall-base-24。这是实验的初始代码版本。如果你没有这个标签可以使用git fetch --tags命令
git apply commit.patch

说明：将 commit.patch 文件中的更改应用到当前分支的代码上。如果显示No such file or directory，说明你在git add .的时候把commit.patch也跟踪了导致切换的时候没有这个文件，你现在需要手动保存commit.patch 文件再复制到这个util-base-24标签下的代码版本里。如果出现already exists in working directory错误，说明你的commit.patch文件出现了自己和自己diff的套娃，此时请在util分支下按如下步骤执行：
- 在.gitignore文件中加上commit.patch这一行
- 使用git rm --cached commit.patch取消对commit.patch文件的跟踪
- 使用git diff util-base-24 HEAD -- . ':!commit.patch' > commit.patch代替原来的make diff指令重新生成commit.patch，回到如何检验提交上去的commit.patch文件是否正确的第一步
make grade

说明：验证是否能正确复现，能通过所有测试
git checkout -f util

说明：强制(-f选项)切换回你正在开发的 util 分支，并丢弃 git apply 或其他未提交的更改
git stash pop（如果你没有进行git stash，可以忽略这一步）

说明：恢复之前 git stash 保存的未提交更改，将它们重新应用到当前工作目录中

在实验过程中，大家注意保存好自己的代码，保存代码的两个方法：

（1）强烈推荐 将代码提交到自己的Github/Gitee等代码托管服务器上，具体操作详见将代码发布至自己的远程仓库。

（2）把整个xv6-oslab24-hitsz目录打包，然后用scp或者mobaXterm工具的sftp拷贝出来，自行保存好整个工程文件，以备下次实验使用。

3. git使用教程¶

git作为开发者常用的开源分布式版本控制系统，在使用远程仓库进行开发时具有不可或缺的作用。

这里给大家推荐一个有趣的Git闯关游戏，解锁Git技能 。通过一系列刺激的关卡挑战，可以帮助大家理解Git的分支究竟是怎么回事：“Learning Git Branching” ，https://learngitbranching.js.org/?locale=zh_CN

如果你想要建立自己的远程仓库并且同步自己的代码、建立一整套完整的工作流，那么请直接阅读将代码发布至自己的远程仓库，那里非常详细地介绍了整个流程。
如果你只是想要提交实验代码，那么按照下面的流程即可。

配置git¶

在使用git提交之前需要进行配置：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

用户名和邮箱具体是什么不重要，但不能没有，随意填写即可。

提交本地修改¶

在部署实验环境部分大家已经将实验的官方仓库clone下来、并且在该仓库里完成了实验，那么提交我们的代码时，只需要将自己所做的改动暂存(add)并提交(commit)即可，在项目的根目录执行如下命令：

git add .
git commit -m "你的提交日志"

良好的提交日志有助于别人快速的了解你的工作，并且便于后续的版本管理和仓库的维护。如果你想学习如何写好commit日志，我们建议你查看commit规范。

获取所做的改动¶

当我们提交完代码后，我们的项目便存储了一个新的版本，这个时候我们通过如下命令即可获取这个新的版本跟原先版本之间的差异，即我们所做的改动，也就是这次实验需要提交的东西：

make diff

执行完该命令后会在项目目录下生成一个 commit.patch 文件，该文件记录了这次实验我们所做的所有更改，也就是本次实验你需要提交的 代码部分，将其拷贝到本地电脑，再跟实验报告一起打包上传至作业提交平台即可。