aecp - Online di Cloud

PROGRAM:

NAMA

aegis salin file - salin file ke perubahan

RINGKASAN

Aegis -CoPy_file [ Option... ] nama file...
Aegis -CoPy_file -Mandiri [ Option... ] nama file...
Aegis -CoPy_file -Daftar [ Option... ]
Aegis -CoPy_file -Membantu

DESKRIPSI

The Aegis -CoPy_file perintah yang digunakan untuk menyalin file ke perubahan. File bernama akan
disalin dari baseline ke direktori pengembangan, dan ditambahkan ke daftar
file dalam perubahan. Versi file yang disalin dari baseline diingat.

Perintah ini dapat digunakan untuk menyalin tes ke dalam perubahan, bukan hanya file sumber. Tes adalah
diperlakukan sama seperti file sumber lainnya, dan tunduk pada proses yang sama.

Peringatan: Jika ada file di direktori pengembangan dengan nama yang sama, file tersebut akan menjadi
ditimpa oleh perintah ini.

Anda juga dapat memberi nama direktori. Semua file sumber dalam direktori bernama, dan semua
direktori di bawahnya, akan disalin dari baseline ke direktori pengembangan,
dan ditambahkan ke daftar file dalam perubahan.

Saat menyalin file secara eksplisit, itu adalah kesalahan jika file tersebut sudah menjadi bagian dari perubahan.
Saat Anda memberi nama direktori, semua file sumber dalam proyek di bawah direktori itu
disalin, kecuali yang sudah ada dalam perubahan. Ini adalah kesalahan jika tidak ada dari
file yang secara implisit dinamai oleh direktori dapat digunakan.

Jika Anda ingin mengubah file sumber yang disalin agar dapat dieksekusi (skrip shell, misalnya)
maka Anda cukup menggunakan yang normal chmod(1) perintah; sebaliknya untuk membuatnya tidak dapat dieksekusi.
Jika salah satu bit file yang dapat dieksekusi diatur pada aede(1) waktu file diingat sebagai
dapat dieksekusi dan semua bit eksekusi (dikurangi umask proyek) akan diatur oleh selanjutnya
aecp(1) perintah.

File Nama Interpretasi
Program aegis akan mencoba menentukan nama file proyek dari nama file
diberikan pada baris perintah. Semua nama file disimpan dalam proyek aegis sebagai relatif
ke akar pohon direktori dasar. Direktori pengembangan dan
direktori integrasi adalah bayangan dari direktori dasar ini, dan nama-nama relatif ini
terapkan di sini juga. File yang dinamai pada baris perintah pertama kali dikonversi ke jalur absolut
jika diperlukan. Mereka kemudian dibandingkan dengan jalur dasar, direktori pengembangan
jalur, dan jalur direktori integrasi, untuk menentukan nama relatif dasar. Dia
kesalahan jika file bernama berada di luar salah satu pohon direktori ini.

The -BAse_RElatif opsi dapat digunakan untuk menyebabkan nama file relatif ditafsirkan sebagai
relatif terhadap jalur dasar; nama file absolut masih akan dibandingkan dengan berbagai
jalur untuk menentukan nama relatif dasar.

The relatif_nama_file_preferensi dalam file konfigurasi pengguna dapat digunakan untuk memodifikasi
perilaku default ini. Lihat aeuconf(5) untuk informasi lebih lanjut.

Proses Sisi efek
Perintah ini akan membatalkan pendaftaran build atau pengujian apa pun, karena menambahkan file lain
secara logis membatalkannya. Jika file konfigurasi proyek ditambahkan, perbedaan apa pun
pendaftaran juga akan dibatalkan.

Ketika file perubahan terdaftar (Aegis -Daftar Ubah_File -Pendek) file yang disalin akan
muncul dalam daftar. Ketika file proyek terdaftar dengan nomor perubahan eksplisit
(Aegis -Daftar File_Proyek -Pendek -Mengubah N) tidak ada file perubahan, termasuk
file yang disalin, akan muncul dalam daftar singkat. Kedua fitur ini sangat membantu ketika
memanggil aegis dari dalam DMT untuk menghasilkan daftar file sumber.

THE DASAR LOCK

Kunci dasar digunakan untuk memastikan bahwa garis dasar tetap dalam keadaan yang konsisten untuk
durasi perintah yang perlu membaca isi file di baseline.

Perintah-perintah yang memerlukan garis dasar untuk konsisten (ini termasuk: a dan b(1)
aecp(1) dan aed(1) perintah) ambil garis dasar Baca baca kunci. Ini adalah kunci non-eksklusif, jadi
perkembangan perubahan secara bersamaan tidak terhalang.

Perintah yang mengubah garis dasar, aeipass(1), mengambil garis dasar menulis kunci. Ini
adalah kunci eksklusif, memaksa aeipass(1) untuk memblokir sampai tidak ada pembacaan baseline yang aktif
kunci.

Ada kemungkinan bahwa salah satu perintah pengembangan di atas akan diblokir hingga proses berlangsung
Aegis -Integrasi_PASS selesai. Ini biasanya berdurasi pendek saat proyek
sejarah diperbarui. Penundaan sangat penting agar perintah ini menerima sinyal yang konsisten
pandangan garis dasar. Tidak ada perintah integrasi lain yang akan menyebabkan perkembangan di atas
perintah untuk memblokir.

Saat fungsi cabang aegis sedang digunakan, kunci baca (non-eksklusif) diambil di
baseline cabang dan juga setiap baseline "induk". Namun, tulisan dasar
kunci (eksklusif) hanya diambil pada baseline cabang; garis dasar "induk" hanya
baca (non-eksklusif) terkunci.

UJI KORELASI

Perintah "aegis -Test -SUGgest" dapat digunakan agar aegis menyarankan regresi yang sesuai
tes untuk perubahan Anda, berdasarkan file sumber dalam perubahan Anda. Ini secara otomatis
memfokuskan upaya pengujian ke pengujian yang relevan, mengurangi jumlah pengujian regresi
perlu untuk yakin bahwa Anda belum memperkenalkan bug.

Korelasi uji dihasilkan oleh perintah "aegis -Integrate_Pass", yang
mengaitkan setiap pengujian dalam perubahan dengan setiap file sumber dalam perubahan. Dengan demikian, masing-masing
file sumber mengumpulkan daftar tes yang telah dikaitkan dengannya di masa lalu.
Ini tidak setepat analisis cakupan kode, tetapi merupakan perkiraan yang masuk akal dalam
praktek.

The aecp(1) dan aenf(1) perintah digunakan untuk mengaitkan file dengan perubahan. Sementara mereka
jangan aktif melakukan asosiasi, ini adalah file yang digunakan oleh aeipass(1) dan
aet(1) untuk menentukan file sumber mana yang terkait dengan pengujian mana.

uji Korelasi Ketepatan
Dengan asumsi bahwa korelasi pengujian akurat dan pengujian merata
didistribusikan di seluruh ruang fungsi, akan ada kurang dari 1/angka kesempatan itu
tes yang relevan belum dijalankan oleh "aegis -Test -SUGgest jumlah" memerintah. Kecil
jumlah kebisingan ditambahkan ke bobot uji, sehingga hal-hal yang tidak terduga terkadang
diuji, dan pengujian yang sama tidak dijalankan setiap saat.

Akurasi uji korelasi dapat ditingkatkan dengan memastikan bahwa:

· Setiap perubahan harus sangat terfokus, tanpa penyertaan file yang serampangan. Ini
menghindari korelasi palsu.

· Setiap item fungsi baru harus ditambahkan dalam perubahan individual, bukan
beberapa bersama-sama. Ini sangat berkorelasi tes dengan fungsionalitas.

· Setiap bug harus diperbaiki dalam perubahan individu, bukan beberapa bersama-sama. Ini
sangat berkorelasi tes dengan fungsionalitas.

· Uji korelasi akan hilang jika file dipindahkan. Ini karena korelasinya dengan
Nama.

Cara terbaik agar pengujian dapat berkorelasi secara akurat dengan file sumber adalah saat ada perubahan
berisi tes dan file-file yang berkaitan dengan fungsionalitas yang diuji. Juga
banyak file palsu akan melemahkan kegunaan korelasi pengujian.

Pemberitahuan
The copy_file_command dalam proyek config file dijalankan, jika disetel. NS file_proyek_‐
Command juga dijalankan, jika disetel, dan jika ada integrasi baru-baru ini. Lihat
aepconf(5) untuk informasi lebih lanjut.

File Tindakan Pengaturan
Ketika perintah ini dijalankan, pertama kali memeriksa file perubahan terhadap file proyek. Jika
ada inkonsistensi, tindakan file akan disesuaikan sebagai berikut:

buat Jika file sedang dibuat, tetapi set perubahan lain terintegrasi yang juga
membuat file, tindakan file di set perubahan yang masih dikembangkan adalah
disesuaikan dengan "modifikasi".

memodifikasi Jika file sedang dimodifikasi, tetapi set perubahan lain terintegrasi yang menghapus
file, tindakan file di set perubahan yang masih dikembangkan adalah
disesuaikan dengan "membuat".

hapus Jika file sedang dihapus, tetapi set perubahan lain terintegrasi yang menghapus
file, file akan dijatuhkan dari set perubahan yang masih dikembangkan.

PILIHAN

Opsi berikut dipahami:

-BAse_RElatif
Opsi ini dapat digunakan untuk menyebabkan nama file relatif dianggap relatif terhadap
dasar pohon sumber. Lihat aeuconf(5) untuk pengguna yang sesuai
Pilihan.

-Current_RElative
Opsi ini dapat digunakan untuk menyebabkan nama file relatif dianggap relatif terhadap
direktori saat ini. Ini biasanya default. Lihat aeuconf(5) untuk
preferensi pengguna yang sesuai.

-Cabang jumlah
Opsi ini dapat digunakan untuk menentukan cabang yang berbeda untuk file asal, bukan
daripada garis dasar. (Lihat juga -Belalai pilihan. Harap Dicatat: -Cabang Option
tidak mengambil nama proyek, hanya akhiran nomor cabang.

-Eyang
Opsi ini dapat digunakan untuk menentukan cabang kakek-nenek (satu naik dari
cabang saat ini) untuk file asal, bukan baseline. (Kakek-kakek
opsi sama dengan opsi “-branch ..”.)

-Mengubah jumlah
Opsi ini dapat digunakan untuk menentukan perubahan tertentu dalam suatu proyek. Lihat
Aegis(1) untuk deskripsi lengkap tentang opsi ini.

-Delta jumlah
Opsi ini dapat digunakan untuk menentukan delta tertentu dalam riwayat proyek untuk
salin file dari, bukan versi terbaru. Jika delta telah
diberi nama (lihat aedn(1) untuk caranya) Anda dapat menggunakan nama delta alih-alih delta
nomor. Ini adalah kesalahan jika delta yang ditentukan tidak ada. Nomor delta
mulai dari 1 dan meningkat; delta 0 adalah kasus khusus yang berarti "ketika cabang"
dimulai".

-DELta_Tanggal string
Opsi ini dapat digunakan untuk menentukan tanggal dan waktu tertentu dalam proyek
history untuk menyalin file dari, bukan versi terbaru. Ini adalah sebuah
kesalahan jika string yang ditentukan tidak dapat ditafsirkan sebagai tanggal dan waktu yang valid.
Kutip string jika Anda perlu menggunakan spasi.

-DELta_From_Change jumlah
Opsi ini dapat digunakan untuk menentukan delta proyek tertentu dari perubahannya
nomor.

-Membantu
Opsi ini dapat digunakan untuk memperoleh informasi lebih lanjut tentang cara menggunakan Aegis
program.

-Mandiri
Opsi ini digunakan untuk menentukan bahwa salinan akan dijalankan secara independen dari
perubahan tertentu. File akan disalin relatif terhadap direktori saat ini.

-Menyimpan
Opsi ini dapat digunakan untuk menyimpan file dan/atau direktori yang biasanya dihapus atau
diganti dengan perintah. Default untuk pengguna hapus_file_preferensi jika tidak
ditentukan, lihat aeuconf(5) untuk informasi lebih lanjut.

-Tidak_Pertahankan
Opsi ini dapat digunakan untuk memastikan bahwa file dan/atau direktori dihapus
atau diganti dengan perintah. Default untuk pengguna hapus_file_preferensi jika tidak
ditentukan, lihat aeuconf(5) untuk informasi lebih lanjut.

-Daftar
Opsi ini dapat digunakan untuk mendapatkan daftar subjek yang sesuai untuk perintah ini.
Daftarnya mungkin lebih umum dari yang diharapkan.

-Tidak_Logging
Opsi ini dapat digunakan untuk menonaktifkan pencatatan otomatis keluaran dan kesalahan untuk
file. Ini sering berguna ketika beberapa perintah perlindungan digabungkan dalam sebuah shell
Script.

-Keluaran nama file
Opsi ini dapat digunakan untuk menentukan file output dari file yang disalin dari
dasar. Hanya satu file dasar yang dapat diberi nama saat opsi ini digunakan. NS
nama file "-" dipahami sebagai keluaran standar. Opsi ini tidak
tambahkan file ke set file perubahan. Tidak kunci diambil ketika opsi ini
digunakan, bahkan kunci baca dasar pun tidak.

-Menulis Berlebihan
Opsi ini dapat digunakan untuk memaksa penimpaan file. Tindakan default adalah untuk
memberikan kesalahan jika file yang ada akan ditimpa.

-Proyek nama
Opsi ini dapat digunakan untuk memilih proyek yang diminati. Ketika tidak -Proyek
opsi ditentukan, AEGIS_PROJECT variabel lingkungan dikonsultasikan. Jika
yang tidak ada, milik pengguna $HOME/.aegisrc file diperiksa untuk default
bidang proyek (lihat aeuconf(5) untuk informasi lebih lanjut). Jika itu tidak ada,
ketika pengguna hanya mengerjakan perubahan dalam satu proyek, proyek
nama default untuk proyek itu. Jika tidak, itu adalah kesalahan.

-Baca_Hanya
Opsi ini dapat digunakan untuk menentukan bahwa file tersebut akan digunakan untuk mengisolasi
berubah dari dasar. Pengguna tidak bermaksud untuk mengedit file. Ini
file harus tidak disalin sebelum pengembangan dapat berakhir.

-Membatalkan
Opsi ini dapat digunakan untuk membatalkan (memutar kembali) perubahan yang telah selesai. Perubahan menjadi
rescind (roll back) ditentukan dengan cara biasa, dengan salah satu --delta
Pilihan.

-Pendek
Opsi ini dapat digunakan untuk menyebabkan cantuman menghasilkan minimal
informasi. Biasanya berguna untuk skrip shell.

-Belalai
Opsi ini dapat digunakan untuk menentukan batang proyek untuk file asal, bukan
daripada garis dasar. (Lihat juga -Cabang opsi, opsi -trunk sama dengan
opsi "-cabang -".)

-Bertele-tele
Opsi ini dapat digunakan untuk menyebabkan aegis menghasilkan lebih banyak output. Secara default perlindungan
hanya menghasilkan output pada kesalahan. Ketika digunakan dengan -Daftar opsi opsi ini
menyebabkan judul kolom ditambahkan.

-Tunggu Opsi ini dapat digunakan untuk meminta perintah Aegis untuk menunggu kunci akses, jika
mereka tidak dapat diperoleh dengan segera. Default untuk pengguna lock_wait_preferensi
jika tidak ditentukan, lihat aeuconf(5) untuk informasi lebih lanjut.

-Tidak_Tunggu
Opsi ini dapat digunakan untuk meminta perintah Aegis untuk mengeluarkan kesalahan fatal jika mengakses
kunci tidak dapat diperoleh dengan segera. Default untuk pengguna
lock_wait_preferensi jika tidak ditentukan, lihat aeuconf(5) untuk informasi lebih lanjut.

Lihat juga Aegis(1) untuk opsi yang umum untuk semua perintah perlindungan.

Semua opsi dapat disingkat; singkatan didokumentasikan sebagai huruf besar,
semua huruf kecil dan garis bawah (_) adalah opsional. Anda harus menggunakan berturut-turut
urutan huruf opsional.

Semua opsi tidak peka huruf besar/kecil, Anda dapat mengetiknya dalam huruf besar atau huruf kecil atau a
kombinasi keduanya, kasus tidak penting.

Misalnya: argumen "-project, "-PROJ" dan "-p" semuanya ditafsirkan sebagai
-Proyek pilihan. Argumen "-prj" tidak akan dipahami, karena berurutan
karakter opsional tidak disediakan.

Opsi dan argumen baris perintah lainnya dapat dicampur secara sewenang-wenang di baris perintah,
setelah pemilih fungsi.

Nama opsi panjang GNU dipahami. Karena semua nama opsi untuk Aegis panjang,
ini berarti mengabaikan awalan tambahan '-'. NS "--Option=nilai"konvensi juga
mengerti.

DISARANKAN ALIAS

Alias ​​​​yang disarankan untuk perintah ini adalah
csh% alias aecp 'aegis -cp \!* -v'
sh$ aecp(){aegis -cp "$@" -v}

GALAT

Ini adalah kesalahan jika perubahan tidak dalam makhluk dikembangkan negara.
Ini adalah kesalahan jika perubahan tidak ditetapkan ke pengguna saat ini.
Ini adalah kesalahan jika file sudah di ubah dan -TimpaTulis pilihan tidak
ditentukan.

EXIT STATUS

The Aegis perintah akan keluar dengan status 1 pada kesalahan apa pun. NS Aegis perintah hanya akan
exit dengan status 0 jika tidak ada error.

LINGKUNGAN VARIABEL

Lihat Aegis(1) untuk daftar variabel lingkungan yang dapat mempengaruhi perintah ini. Lihat
aepconf(5) untuk file konfigurasi proyek proyek_spesifik bidang untuk cara mengatur
variabel lingkungan untuk semua perintah yang dijalankan oleh Aegis.

CONTOH

Berikut adalah beberapa contoh sederhana. Ingat bahwa sebagian besar perintah relatif terhadap arus
direktori, meskipun contoh-contoh ini menganggap Anda berada di dasar pengembangan
pohon direktori.

Copy Seluruh Project
Untuk menyalin seluruh proyek ke dalam perubahan Anda, gunakan perintah
aecp.
Titik akhir adalah bagian dari perintah, artinya "direktori saat ini dan semuanya"
di bawahnya". Ini berfungsi untuk direktori mana pun di pohon sumber proyek Anda, jika Anda mau
lebih selektif.

menghasilkan Terdahulu Project Versi
Anda ingin mereproduksi sumber untuk versi sebelumnya dari proyek Anda,
Anda perlu mengetahui nomor edelta (gunakan ael sejarah proyek untuk menemukannya). Kemudian gunakan ini
perintah:
aecp-delta n .
dimana n adalah nomor delta dari sejarah proyek. Sekali lagi, titik akhir adalah bagian dari
perintah. Dengan menggunakan $versi substitusi (lihat aesub(5) untuk informasi lebih lanjut) Anda
dapat menanamkan nomor delta ini ke dalam program Anda sebelum mendistribusikannya.

Dimungkinkan juga untuk memberikan nomor perubahan sebelumnya, sebagai gantinya, menggunakan perintah ini:
aecp -delta-dari-perubahan n .
dimana n adalah perubahan jumlah bunga. Sekali lagi, titik akhir adalah bagian dari
perintah.

Membatalkan a Perubahan
Ketika Anda perlu membatalkan (mundur) perubahan yang telah selesai, itu mungkin akan menjadi beberapa
waktu yang lalu, jadi Anda perlu mengetahui nomor delta atau mengubah nomor. Gunakan perintah ini:
aecp-delta n -batalkan.
dimana n adalah jumlah delta bunga. Semua varian -delta lainnya juga berfungsi, jadi
jika Anda mengetahui nomor perubahan, Anda dapat lebih selektif tentang file mana yang akan disalin:
aecp -delta-dari-perubahan n `aegis -l lih -ter -c n`
dimana n adalah perubahan jumlah bunga. Ini hanya menyalin file yang ada di
perubahan yang menyinggung.

Gunakan aecp online menggunakan layanan onworks.net