Files
ioccc/next/submit.md
T
Cody Boone Ferguson a4fd6f45d3 Update pw-change.html, register.html, submit.html
Some images are no longer used but they still exist here for the time
being. Text is used instead though based on some discussion text might
have to change.

Adjusted alt text of some images a bit.

A more thorough look at the way these updates look must still be done.
2025-03-02 13:24:28 -08:00

5.2 KiB

How to upload your submission to the IOCCC

IMPORTANT NOTE: The IOCCC submit server is only ready for submissions ONLY WHEN THE CONTEST IS open.

See current status of the IOCCC for details on the contest status. IMPORTANT NOTE: When the contest is closed, the IOCCC submit server might be offline and unreachable as a website.

To login, open https://submit.ioccc.org in your browser. Fill in your login credentials and click "Login". It might look something like:

submit server login page screenshot

NOTE: if the contest is NOT open you will see something like this instead:

The contest is NOT yet open for submissions.
Sorry (tm Canada 🇨), the IOCCC is not yet open.
The IOCCC is scheduled to open at 2025-03-05 23:19:17.131107 UTC.

Message(s):
The IOCCC is not yet open for submissions.

Assuming it is open, and if you've not logged in before, you'll have to change your password first. See the file pw-change.html for more details. After that you will have to log back in.

Once you've logged in, you will see submit slots. Each slot is for one submission so if you update a submission, make sure you choose the right one so you do not replace the wrong one!

Here is what it looks like without any uploads and no slot selected:

submit server submission slots list to select from with no slot selected
screenshot

Select a slot and then select a file by clicking the button "Choose File". After doing this, it should look something like:

submit server submission slot selected with a file chosen to be uploaded screenshot

If you need to change the file to upload, you can mouseover the file and click it. If you wait a moment it'll show the current filename.

Once you're certain you have selected the correct file, click "Submit", below the file selection step.

When it's uploaded it should say something like:

• Uploaded file: submit.9971ada4-b6ae-427d-a7ec-e67a30362cdb-0.1740838915.txz

And in the slot it will give you important details like:

  • the status of the submission (on upload it will say: "uploaded file into slot").
  • the filename, which will be in the correct format, assuming you used mkiocccentry(1) which is HIGHLY recommended so that you do not break Rule 17!
  • the file length, which txzchk(1) will also verify (the file itself and the tarball listing).
  • the upload date.
  • the SHA256 hash of the file.

Now if you're done, log out.

If, on the other hand,, you upload a file that is too big you will see something like:

The file size of N exceeds the maximum size of 3999971.

And if you try uploading an empty file you'll instead see:

The must not be empty.

And if you see something like:

Filename for slot: 0 must match this regular expression: ^submit.dd3d30c2-d8d0-4506-adcd-d4e029147f39-0\.[1-9][0-9] {9,}\.txz$

where 0 is the slot and dd3d30c2-d8d0-4506-adcd-d4e029147f39-01 is the UUID then you MUST upload a properly named XZ compressed tarball, MAKING SURE you package it with mkiocccentry!

If later on you log in and see something like:

Status: server slot error code: 1! Use mkiocccentry to rebuild and resubmit to this slot.

or:

Status: submit file failed the txzchk test! Use mkiocccentry to rebuild and resubmit to this slot.

... or ANY other error then you MUST FIX your submission, repackage your tarball with mkiocccentry and upload to the same slot again! If you do not fix this your submission WILL be rejected for violating Rule 17!

After the submission deadline is reached, you can log in to check the status of your submissions. This is what it will say when the judges have verified that your tarball / submission has been validated (NOT judged), by txzchk(1) and chkentry(1):

Status: the format of this submission has been validated.

IMPORTANT: this does NOT mean that your submission does not violate the rules or that everything is OK once the tarball is extracted; it simply means the tests performed by the tools passed. If you find a flaw in the tool and abuse it and the tests pass then you stand a significant chance of having your submission rejected for violating Rule 17, even if the tests passed.

For details on txzchk, see the FAQ on "txzchk".

For details on chkentry, see the FAQ on "chkentry".

If you need more information on the two JSON files, see FAQ on the ".info.json file" and the FAQ on the ".auth.json file".