CodeSampleX

Exemplo

modernc.org/libc v1.73.5: NewTLS

Amostra verificada para golang modernc.org/libc v1.73.5: NewTLS. O contrato rodou em go 1.26 · linux debian/x64 · docker e passou.

sha256:a555b790415fc7325a545b106de43726f3108892480dcf7be8a2807cabd7bd4a

Esta rede oferece uma coisa: uma amostra que compila. Ela a executou em um sandbox e guardou o recibo assinado. Não classifica nem garante nada — se o mesmo código compila onde você está, ela não mediu. Quantas chaves de assinatura distintas enviaram um recibo de contrato aprovado. Uma é só o autor; mais de uma significa que outra pessoa também o compilou. Uma chave é gerada por conta própria e não tem identidade registrada por trás, então conta chaves, não pessoas. MIT-0

Evidência de execução

O ambiente declarado e as execuções assinadas ficam separados, para você ver exatamente o que esta amostra executou e onde.

Base da evidência
Contrato assinado aprovado
Recibos de verificação
2
Chaves de assinatura que o compilaram
1
Ambiente declarado linux 24 · ubuntu · glibc 2.39 x64 go

Ambientes das execuções de verificação

Ambiente Contrato Etapas Execução
go 1.26 · linux debian/x64 · docker ed25519:c1973797be207ac4 SKIPPED compile:SKIPPED · contract:SKIPPED · load:SKIPPED · resolve:FAIL
CONTAINER_RUN · golang@1golang:1.26@sha256:e30143be198a…
2026-10-20
go 1.26 · linux debian/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1golang:1.26@sha256:e30143be198a…
2026-10-20

Caso

HOW
Objetivo
verify NewTLS in pkg:golang/modernc.org/libc@v1.73.5
Pacotes
Símbolos
  • NewTLS
Criado
2026-10-20T01:54:28Z

Contrato

  1. libc.NewTLS returns a non-nil *libc.TLS instance initialized with a positive ID and 0 stack slots in use
  2. subsequent calls to libc.NewTLS assign distinct monotonically increasing thread IDs
  3. a *libc.TLS created by libc.NewTLS supports paired stack memory allocation and release via Alloc and Free while tracking StackSlots
  4. a *libc.TLS created by libc.NewTLS provides a valid thread-local errno pointer via libc.X__errno_location and zeroes its state on Close

Arquivos

  • PROMPT.md
  • csx.json
  • go.mod
  • go.sum
  • spec.json
  • test/contract.go
  • tls_demo.go

Baixar o artefato de código-fonte (tar.gz)

Código-fonte

PROMPT.md
Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify NewTLS in pkg:golang/modernc.org/libc@v1.73.5
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/modernc.org/libc@v1.73.5
Demonstrate these symbols/APIs:
  - NewTLS

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.
csx.json
{"case":{"caseId":"case:sha256:bc374139af0538e5dbd1ea55f6d46687ba67ccb5bd55e54d974e828de6016d02","contract":["libc.NewTLS returns a non-nil *libc.TLS instance initialized with a positive ID and 0 stack slots in use","subsequent calls to libc.NewTLS assign distinct monotonically increasing thread IDs","a *libc.TLS created by libc.NewTLS supports paired stack memory allocation and release via Alloc and Free while tracking StackSlots","a *libc.TLS created by libc.NewTLS provides a valid thread-local errno pointer via libc.X__errno_location and zeroes its state on Close"],"goal":"verify NewTLS in pkg:golang/modernc.org/libc@v1.73.5","kind":"HOW","packages":["pkg:golang/modernc.org/libc@v1.73.5"],"schemaVersion":1,"symbols":["NewTLS"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/modernc.org/libc@v1.73.5"],"schemaVersion":1,"subject":"pkg:golang/modernc.org/libc@v1.73.5","symbols":["NewTLS"],"verifierAdapter":"golang@1"}
go.mod
module sample

go 1.26.6

require modernc.org/libc v1.73.5

require (
	github.com/dustin/go-humanize v1.0.1 // indirect
	github.com/google/uuid v1.6.0 // indirect
	github.com/mattn/go-isatty v0.0.20 // indirect
	github.com/ncruces/go-strftime v1.0.0 // indirect
	github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
	golang.org/x/sys v0.46.0 // indirect
	modernc.org/mathutil v1.7.1 // indirect
	modernc.org/memory v1.11.0 // indirect
)
go.sum
github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k=
github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM=
github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
golang.org/x/tools v0.46.0 h1:7jTurBkPZu4moS/Uy4OQT1M+QBlsj3wejyZwsT8Z7rk=
golang.org/x/tools v0.46.0/go.mod h1:FrD85F8l+NWL+9XWBSyVSHO6Ne4jutsfIFba7AWQ5Ys=
modernc.org/cc/v4 v4.29.0 h1:CXgwL8cvxmyzBQZzbSl/6xFtMCryb6u8IOqDci39cgc=
modernc.org/cc/v4 v4.29.0/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI=
modernc.org/ccgo/v4 v4.34.5 h1:hcwnthv2/LBl+mRLOYwnQA/LuW44Oln1NQlWppNaS1Q=
modernc.org/ccgo/v4 v4.34.5/go.mod h1:aow0HNkO30OSA/2NrtDXkis92ff8ZFiDOmDOPhqhF8U=
modernc.org/fileutil v1.4.0 h1:j6ZzNTftVS054gi281TyLjHPp6CPHr2KCxEXjEbD6SM=
modernc.org/fileutil v1.4.0/go.mod h1:EqdKFDxiByqxLk8ozOxObDSfcVOv/54xDs/DUHdvCUU=
modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI=
modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito=
modernc.org/gc/v3 v3.1.4 h1:2g65LGVSmFQrXeITAw97x7hCRvZFcyE1uDP+7Vng7JI=
modernc.org/gc/v3 v3.1.4/go.mod h1:HFK/6AGESC7Ex+EZJhJ2Gni6cTaYpSMmU/cT9RmlfYY=
modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks=
modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI=
modernc.org/libc v1.73.5 h1:G34rN/cRqL+zOUnrbz9uPq/+OxJ8/vzQ2CQwTJ42Wmw=
modernc.org/libc v1.73.5/go.mod h1:+Aoyx4M0etg6GikzCrip1VtvAtUlMlo2Aq+GHwQSqOA=
modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU=
modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg=
modernc.org/memory v1.11.0 h1:o4QC8aMQzmcwCK3t3Ux/ZHmwFPzE6hf2Y5LbkRs+hbI=
modernc.org/memory v1.11.0/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw=
modernc.org/opt v0.2.0 h1:tGyef5ApycA7FSEOMraay9SaTk5zmbx7Tu+cJs4QKZg=
modernc.org/opt v0.2.0/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns=
modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w=
modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE=
modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0=
modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A=
modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y=
modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM=
spec.json
{
  "schemaVersion": 1,
  "goal": "verify NewTLS in pkg:golang/modernc.org/libc@v1.73.5",
  "kind": "HOW",
  "packages": [
    "pkg:golang/modernc.org/libc@v1.73.5"
  ],
  "symbols": [
    "NewTLS"
  ]
}
test/contract.go
package main

import (
	"fmt"
	"os"

	"modernc.org/libc"
	"sample"
)

func assert(cond bool, msg string) {
	if !cond {
		fmt.Fprintln(os.Stderr, "assertion failed:", msg)
		os.Exit(1)
	}
}

func main() {
	tls1 := libc.NewTLS()
	assert(tls1 != nil, "NewTLS must return non-nil *libc.TLS")
	assert(tls1.ID > 0, "NewTLS must assign a positive thread ID")
	assert(tls1.StackSlots() == 0, "NewTLS must initialize with 0 stack slots in use")

	tls2 := libc.NewTLS()
	assert(tls2 != nil, "second NewTLS call must return non-nil *libc.TLS")
	assert(tls2.ID > tls1.ID, "subsequent NewTLS calls must assign distinct increasing IDs")

	tls2.Close()
	tls1.Close()
	assert(tls1.ID == 0 && tls2.ID == 0, "Close must reset the TLS struct state")

	info := sample.InspectNewTLS(0x123456789abcdef0)
	assert(info.ID > 0, "InspectNewTLS must observe a positive TLS ID")
	assert(info.InitialSlots == 0, "initial stack slots must be 0")
	assert(info.AllocatedPtr != 0, "Alloc on TLS from NewTLS must return non-zero pointer")
	assert(info.AllocatedSlots == 1, "Alloc must increment StackSlots to 1")
	assert(info.RoundTripValue == 0x123456789abcdef0, "allocated TLS stack slot must store and load 64-bit value")
	assert(info.FreedSlots == 0, "Free must decrement StackSlots back to 0")
	assert(info.ErrnoPtr != 0, "X__errno_location on TLS from NewTLS must return non-zero pointer")
	assert(info.IDAfterClose == 0, "Close must zero TLS fields")
}
tls_demo.go
package sample

import (
	"unsafe"

	"modernc.org/libc"
)

type TLSInspection struct {
	ID               int32
	InitialSlots     int
	AllocatedSlots   int
	FreedSlots       int
	AllocatedPtr     uintptr
	RoundTripValue   int64
	ErrnoPtr         uintptr
	IDAfterClose     int32
}

func InspectNewTLS(val int64) TLSInspection {
	tls := libc.NewTLS()
	info := TLSInspection{
		ID:           tls.ID,
		InitialSlots: tls.StackSlots(),
		ErrnoPtr:     libc.X__errno_location(tls),
	}

	ptr := tls.Alloc(8)
	info.AllocatedPtr = ptr
	info.AllocatedSlots = tls.StackSlots()
	*(*int64)(unsafe.Pointer(ptr)) = val
	info.RoundTripValue = *(*int64)(unsafe.Pointer(ptr))
	tls.Free(8)
	info.FreedSlots = tls.StackSlots()

	tls.Close()
	info.IDAfterClose = tls.ID
	return info
}

Seeder de origem

anônimo