/* * Copyright (c) 2020, Peter Elliott * Copyright (c) 2021, Idan Horowitz * Copyright (c) 2022, the SerenityOS developers. * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include namespace Archive { TarFileStream::TarFileStream(TarInputStream& tar_stream) : m_tar_stream(tar_stream) , m_generation(tar_stream.m_generation) { } ErrorOr TarFileStream::read(Bytes bytes) { // Verify that the stream has not advanced. VERIFY(m_tar_stream.m_generation == m_generation); auto header_size = TRY(m_tar_stream.header().size()); auto to_read = min(bytes.size(), header_size - m_tar_stream.m_file_offset); auto slice = TRY(m_tar_stream.m_stream->read(bytes.trim(to_read))); m_tar_stream.m_file_offset += slice.size(); return slice; } bool TarFileStream::is_eof() const { // Verify that the stream has not advanced. VERIFY(m_tar_stream.m_generation == m_generation); auto header_size_or_error = m_tar_stream.header().size(); if (header_size_or_error.is_error()) return true; auto header_size = header_size_or_error.release_value(); return m_tar_stream.m_stream->is_eof() || m_tar_stream.m_file_offset >= header_size; } ErrorOr TarFileStream::write(ReadonlyBytes) { // This is purely for wrapping and representing file contents in an archive. VERIFY_NOT_REACHED(); } ErrorOr> TarInputStream::construct(NonnullOwnPtr stream) { auto tar_stream = TRY(adopt_nonnull_own_or_enomem(new (nothrow) TarInputStream(move(stream)))); TRY(tar_stream->load_next_header()); return tar_stream; } TarInputStream::TarInputStream(NonnullOwnPtr stream) : m_stream(move(stream)) { } static constexpr unsigned long block_ceiling(unsigned long offset) { return block_size * (1 + ((offset - 1) / block_size)); } ErrorOr TarInputStream::advance() { if (finished()) return Error::from_string_literal("Attempted to advance a finished stream"); m_generation++; // Discard the pending bytes of the current entry. auto file_size = TRY(m_header.size()); TRY(m_stream->discard(block_ceiling(file_size) - m_file_offset)); m_file_offset = 0; TRY(load_next_header()); return {}; } ErrorOr TarInputStream::load_next_header() { size_t number_of_consecutive_zero_blocks = 0; while (true) { auto header_span = TRY(m_stream->read(Bytes(&m_header, sizeof(m_header)))); if (header_span.size() != sizeof(m_header)) return Error::from_string_literal("Failed to read the entire header"); // Discard the rest of the header block. TRY(m_stream->discard(block_size - sizeof(TarFileHeader))); if (!header().is_zero_block()) break; number_of_consecutive_zero_blocks++; // Two zero blocks in a row marks the end of the archive. if (number_of_consecutive_zero_blocks >= 2) { m_found_end_of_archive = true; return {}; } } if (!TRY(valid())) return Error::from_string_literal("Header has an invalid magic or checksum"); return {}; } ErrorOr TarInputStream::valid() const { auto const header_magic = header().magic(); auto const header_version = header().version(); if (!((header_magic == gnu_magic && header_version == gnu_version) || (header_magic == ustar_magic && header_version == ustar_version) || (header_magic == posix1_tar_magic && header_version == posix1_tar_version))) return false; // POSIX.1-1988 tar does not have magic numbers, so we also need to verify the header checksum. return TRY(header().checksum()) == header().expected_checksum(); } TarFileStream TarInputStream::file_contents() { VERIFY(!finished()); return TarFileStream(*this); } TarOutputStream::TarOutputStream(Core::Stream::Handle stream) : m_stream(move(stream)) { } ErrorOr TarOutputStream::add_directory(DeprecatedString const& path, mode_t mode) { VERIFY(!m_finished); TarFileHeader header {}; header.set_size(0); header.set_filename_and_prefix(DeprecatedString::formatted("{}/", path)); // Old tar implementations assume directory names end with a / header.set_type_flag(TarFileType::Directory); header.set_mode(mode); header.set_magic(gnu_magic); header.set_version(gnu_version); header.calculate_checksum(); TRY(m_stream->write_entire_buffer(Bytes { &header, sizeof(header) })); u8 padding[block_size] = { 0 }; TRY(m_stream->write_entire_buffer(Bytes { &padding, block_size - sizeof(header) })); return {}; } ErrorOr TarOutputStream::add_file(DeprecatedString const& path, mode_t mode, ReadonlyBytes bytes) { VERIFY(!m_finished); TarFileHeader header {}; header.set_size(bytes.size()); header.set_filename_and_prefix(path); header.set_type_flag(TarFileType::NormalFile); header.set_mode(mode); header.set_magic(gnu_magic); header.set_version(gnu_version); header.calculate_checksum(); TRY(m_stream->write_entire_buffer(ReadonlyBytes { &header, sizeof(header) })); constexpr Array padding { 0 }; TRY(m_stream->write_entire_buffer(ReadonlyBytes { &padding, block_size - sizeof(header) })); size_t n_written = 0; while (n_written < bytes.size()) { n_written += MUST(m_stream->write(bytes.slice(n_written, min(bytes.size() - n_written, block_size)))); } TRY(m_stream->write_entire_buffer(ReadonlyBytes { &padding, block_size - (n_written % block_size) })); return {}; } ErrorOr TarOutputStream::add_link(DeprecatedString const& path, mode_t mode, StringView link_name) { VERIFY(!m_finished); TarFileHeader header {}; header.set_size(0); header.set_filename_and_prefix(path); header.set_type_flag(TarFileType::SymLink); header.set_mode(mode); header.set_magic(gnu_magic); header.set_version(gnu_version); header.set_link_name(link_name); header.calculate_checksum(); TRY(m_stream->write_entire_buffer(Bytes { &header, sizeof(header) })); u8 padding[block_size] = { 0 }; TRY(m_stream->write_entire_buffer(Bytes { &padding, block_size - sizeof(header) })); return {}; } ErrorOr TarOutputStream::finish() { VERIFY(!m_finished); constexpr Array padding { 0 }; // 2 empty records that are used to signify the end of the archive. TRY(m_stream->write_entire_buffer(ReadonlyBytes { &padding, block_size })); TRY(m_stream->write_entire_buffer(ReadonlyBytes { &padding, block_size })); m_finished = true; return {}; } }